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Part I-Introduction 


Part I — — Introduction • 

The systom provides the tools necessary to fully exploit the superb 

esolution offered by dot matrix printers, such as the Epson line of 
>rinters. The system is embodied by three separate programs, the main 
me being the printing program (Pfont). Most users will be mainly 
nterested in this program. The other two programs allow editing of 
existing fonts (Efont) and creation of new fonts from a master character 
table (Cfont). 

Pfont achieves high printing quality by passing the print head over each 
character many times — six times for standard characters, more for tall 
characters — moving the paper as little as a 216‘^ of an inch between 
each pass. Faster, rough draft modes are obtained by using fewer passes. 

1.1 WHAT TO READ 

Th6 remainder of the manual is composed of three parts, describing Pfont 
(part P), Efont (part E) and Cfont (part C). Most users of the 3wn^3<yrU 
system will probably be concerned only about printing text files and will 
not care about editing or creating fonts. If that is the case only part P 
needs to be read. Parts E and C should be read by those desiring to edit 
or create fonts. Part E also contains interesting information on the 
detailed printing method and vertical line spacing limitations. This latter 
information will be critical to anyone trying to modify a word processor for 
use with but should not be necessary for occasional users of 

Efont. 

There are numerous useful appendices. The glossary defines terms that 
may be foreign to casual computer users and also defines terms specific to 
the world of typesetting and character design. The last appendix gives a 
summary of the commands and parameters accepted by all three programs 
of and can be consulted during reading of the manual to get a 

better feeling for the whole of the system structure. 

1.2 PROGRAM INTERACTION 

• 

The three programs in perform different functions and, of 

necessity, have slightly different user interfaces. Pfont- asks the user to 
specify some j)arameters and then it prints for an extended period time. 
In computer science terms we would say it has a declarative nature. Efont 
and Cfont have more of an interactive command interface and thus have a 

* ■ I 

more procedural nature. All of the programs provide online help, but 
Pfont in particular provides extensive help (on demand) and has very 
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-iv.,. 

along with the programs and 

'is generally a collection of characters 
ties of the characters are given in printer’s 
one 72“** of an inch). For comparison, 
Jir^nerally 10 to 12 points (unrelated to 10 and 12 
l^hai£lsms). Two common font styles are Roman and 
^pindix 2 presents a variety of other font styles. Several 
^ italic or Md may be cont^dned within one font family, 
ai^perscript fonts are usually smaUer point size fonts 
or higher than other fonts. The glossary contains more 
lotillod definitions of these terms but this short introduction should suffice 
for reading of subsequent parts of the manual. 
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Part P -— Printing with Fonts 

As mentioned in the introduction, Pfont is the primary program in the 
trfo of programs. The basic function of Pfont is to format and 
print text on a dot matrix printer. The text can be provided to Pfont 
either from a file on disk or interactively from the keyboard. The text file 
can be printed by typing 

A> Pfont tftxt.ff,)- 

The underlined characters are typ^ by the user, ‘A>’ is the operating 
system prompt, and V’ represents the return (enter) key. Note that this 
and other examples make use of drive ‘A\ Pfont may be used with any 
disk drive, including a hard disk. In the example above, ‘text.fP is the 
name of the file to be printed. Executing Pfont in this way will cause the 
contents of ‘text.fP to be printed using the initial settings for unspecified 
parameters such as line spacing, line width, font size and style, etc. These 
settings can easily be changed. For example, 

A> Pfont text.ff ^^sp .61^ 

will cause the file to be printed as. before but with a half inch of space 
between successive lines of text. In general, many different parameters can 
be specified on the command line. Alternatively, parameters may be 
specified interactively to take advantage of the extensive online help‘within 
Pfont. To specify parameters interactively, simply execute Pfont without 
any command line arguments, e.g. 

k> Piout^ 

Parameters can then be specified in response to the Pfont prompt, which is 
composed of two angle brackets. For example, 

A>Pfont£ 

» text.ff +sp .5iA 

» ^ 

is equivalent to the previous example where the interline spacing was set to 
a half inch. The extra return ends the interaction and tells Pfont to begin 
printing. 

The user can intermix specification of parameters on the command line and 
interactive specification; help can be obtained about the parameters at any 
time. 
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his completes the introduction to the Pfont printing parameters. The 
her aspect of Pfont to be explained is the types of special commands that 
in appear in the text file. That is, .different words on a line of text can 
3 printed in different fonts, words can be underlined, and lines can be 
ntered or flushed against the right margin. These actions and many 
hers are accomplished by placing commands in the text file at the 
’ation where the action is desired. All commands are of the form: 
^^kslash (\) followed by a single letter. For example ‘...\uquality 
ftware\u...’ appearing in the text file would cause the words ‘quality’ and 
)ftware’ to be underlined, as in quality software . The ‘\u’ command is 
iilled an underlining ^toggle”; i.e., it turns underlining on if it was off and 
f if it was on. The most commonly used command is probably the ‘\f 
hange font) conunand. The ‘\f is followed by a single digit specifying a 
i w font number. Thus, ‘...\f2Fancy Font\fD..,’ would cause ‘Fancy’ and 
"onf to be printed in font number 2, as in and the remainder 

the text to be printed in font zero; the correspondence between font 
Limbers and the actual font is specified on the command line by the Pfont 
- fo’ parameter and can be changed with each printing of the text file if 
sired. (In the case above, font 2 corresponds to the font FF12.fon). The 
parameter is described in detail in section P.3 and the complete list 
allowable in—text commands is described in the following section. 

» ow to Read About Pfont 

I iis introduction provides you with the basic ideas behind Pfont — the 
ipability to select and specify printing parameters and the embedded 
-text commands to control the appearance of sections of text. 

l ie remaining sections of part P detail the in—text commands, the modes 
interaction with Pfont, and the parameters. They also provide 
ilditional information on controlling printing and on understanding and 
^covering from errors. 

!1 commands and parameters are described in a consistent format to aid 
aderstanding and to provide convenient reference. 


hich Disk Drives To Use 


diskettes are not copy protected and therefore you can rearrange 
e contents of the diskettes in any manner you choose. K you are using a 
stem with a hard disk, you should copy the diskettes to your 

ird disk. For most floppy diskette based systems, the following 
nfiguration is recommended. 
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1. Create a diskette, formatted and containing a copy of your 
operating system (called the Pfont diskette). Copy Pfont and as 
many frequently used fonts as will fit onto the diskette (copy 
from the 9a/n^ diskettes using your system’s Copy or PIP 

facility. To use Pfont, you must include at least the following 
files on the Pfont diskette: 


Fancfont.pro configuration file 

Pfont.hle,Pfont.hlp Help files (may be omitted) 
Pfont.exe (DOS only)Main Pfont program 

Pfont.com (CP/M only) Main Pfont program 

Pfonto0.ovl,Pfontol.ovl,Pfonto2.ovl,Pfonto3.ovl 

(auxilliary Pfont overlays) 


2. Create a blank, formatted diskette (called the diskette); copy 
onto this diskette any special or extra fonts not on the Pjoni 
diskette, but needed to print your text. 


3. Place your word processing diskette (not part of S*am^3><yrU) in disk 
drive A and your text disk in drive B. 

4. Use your word processor to create a file on the text disk (in drive 

B). The file should contmn text to be printed by and 

any embedded commands to change fonts and format 

that you desire. 

5. Remove your word processing diskette from drive A and insert 
the P/onf diskette (created in step 1) in drive A. 

* 

6. Now use Pfont indicating the name of the file to be printed, 
desired fonts and other printing directives. Make sure to precede 
the names of all text files and font files with *B:’ if they are on 
the disk in drive B. For example, 

A> Pfont B:Text.ff +F0 Romi12 B;01de20 

will print the contents of the file ‘Text.fF using the Roman 12 pt. 
font (found on the Pfont diskette) and the Old English 20 pt. 
font (found on the text diskette in drive B). - 
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1 THE TEXT FILE . 

le most common use of Pfont is to print a file containing text. The text 
e can be created with any standard text editor or with most word 
ocessing software. The use of Pfont was introduced in the previous 
ctions and is described in detail in sections P.2 and P.3. Pfont can 
tually be used to print the contents of any ASCII (DOS or CP/M) file, 
gardless of how the file was created. 

is usually desirable to change fonts and specify style and formatting 
formation in the text file. There is a collection of in—text (embedded) 
mmands that indicate appearance and formatting characteristics of 
rtions of the text to be printed. Each of the commands is preceded by 
command indicator to distinguish it from normal text. The built-in 
mmand indicator is the backslash character (\), however if this is 
onvenient for a particular file, you can use the Command Indicator (Cl) 
xameter (see section P.3) to specify a different command indicator for the 
tire text file. The conunand indicator is followed by one or a few 
aracters to specify the details of the requested appearance. The 
aracters following the command indicator may be either upper or lower 
se. ' 


lus all embedded conunands follow the format: 

<Command IndicatorXCommand Character><Value> 

4e that the notation name is used here and throughout the 
mual to describe input to You never type the or the 

jrds between these symbols. You, instead, type an item described by this 
tation. An. example of the notation and of the commands described 
•ove is, 


\fB 

iicating that subsequent text is to be printed using font 6. The ‘\’ is 
e <Command Indicator>, ‘P is the <Conimand Character> and ‘5’ is the 
v'^alue>. - 

me embedded commands require a value that is a measure of distance, 
ese values must therefore specify the iinit (e.g. inches, centimeters, etc.) 

be used for the measure. The number specifying distance must be 
mediately followed by a single character, represents inches, ‘d’ printer 

ecific dots, ‘c’* centimeters, and ‘u’ a user defined unit. 
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or example, * 

\h3.Bi 

pecifies a positioning of the printhead exactly 3 1/2 inches to the right of 
he left margin. 

•Inally, many measures can specify relative as well as absolute positioning. 
This means that you don’t always have to measure from the left margin or ^ 
op of the page, but can also measure relative to the current print position. 
This is achieved by inserting a or ’ before the value. For example: 

I 

\h+2c indicates to move the printhead forward 2 centimeters. 

Mid 

\h-1.6i indicates to move the printhead backward 1 1/2 inches. 

The complete form of an embedded command with a measured value is: 

<Command Indicator><Command Character> 

<+ 9L “ option><Value><Unit> 


<Command Indicator> is ‘\’ 

<Command Character> is the name of a command, e.g. ‘h’ in ‘\h+3.5i’ 

<+ or — option> is ‘+’ (measure forward from current print location) 

’ (measure backward from current print location) 

or nothing (measure from the top of page or left margin 
depending upon the command) 

<Value> a number, possibly with a fractional part (e.g. .4, 5.72, 3) 

<Unit> ‘i’ inches, ‘c’ centimeters, ‘d’ horizontal or vertical printer 

specific dots, ‘u’ user defined unit (see UU parameter, 
section P.3). The MX version of is designed to 

print 120 dots per inch horizontally while the FX version 
prints 240 dots per inch horizontally. Both versions use 
a vertical dot unit of 72 dots per inch (although printing 
is actually 216 dots per vertical inch). 

Note: in all cases, you must never type a space or. any other extra 
character inside of an embedded command. CP/M users note that there is 
a 2 digit accuracy limitation in the fractional part of measured values and 
that conversion of centimeters to dots is not exact. 

The embedded commands are described in the following pages. Ei^h 
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command is described in terms of its purpose, its syntax (as in the example 
above), how to use the command (usage), and at least one example of use. 
Additionally, the possible values and errors are detailed. Finally, a set of 
notes and suggestions for use are included. The syntax line contains the 
word break at its right edge if the embedded command causes an implicit 
break. Several commands cause such a break in order to allow more 
natural separation between paragraphs, headings, indented sections etc. An 
implicit break means that a \b is automatically processed (by Pfont) before 
such a command is processed. Implicit breaks only apply when using word 
wrap — see \w and \b embedded commands in section P.1.2. 

Three short commands have been added for convenience and compatibility 
with other software. These commands are ‘Control—H’ (see \—), 
'Control—!’ (see \t) and ‘Control—L’ (see \p). 

P.1.1 Terminology 

You will need to know a few words and symbols used in describing the 
Pfont commands and parameters. A quick summary follows, a more 
complete terminology is described in the glossary of this manual. 

< . . • > Brackets are used to describe a value. You do not actually type 
any words contained in the brackets nor should you type the 
brackets, (e.g. <list of real numbers between 0 and 150 inches>, 
indicates a list of numbers — you might type ‘1.1 3 4.675’). 

r 

list One or more values; the values are separated by at least 1 space 

(e.g. 5 10.5 12 36 or Filel File2 File3). 

String A sequence of characters. Any characters may appear in a string, 
but if a space character is in a string, the entire string must be 
surrounded by double quotes to mark its beginning and end (and 
to distinguish it from a list). For example, "This is 1 string”, is 
a string. If you wish to have the ” character appear within a 
string, you must type the quote twice. Example, ”This ””string”” 
contains quotes”. The paired quotes are undoubled when the 
string is used, thus the example yields: 

This ”string” contains quotes 

I ateger A whole number, no fractional part (e.g. 1, 3, 12, 0, 5). There 
are no negative numbers in Pfont parameters (although negative 
numbers may be used within embedded commands). 
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Digit A single digit, usually between 0 and 9 inclusive. 

Eeal Number A number that may include a fractional part (e.g. 1.5, 

.7, 0.2, 6, 12.8). 

Horixontal Measure A number that may include a fractional part and must 
be immediately followed by a unit (e.g. 1.5i, .7c, 0.2i, 6d). A 
Horizontal Measure indicates a distance across the page, usually 
between 0 and the current or maximum line width (8 or 13.6.^ 
inches depending upon printer). It always specifies a distance 
either from the left margin or from the current print position. 

I 

Vertical Measure A number that may include a fractional part and must 
be immediately followed by a unit (e.g. 1.5i, .7c, 0.2i, 6d). A 
vertical measure indicates a distance up and down the page and 
is usually a number between the current vertical print head 
position and 425 inches. For printers that can move the paper 
backwards, the Vertical Measure can result in a position between 
0 and 425 inches from the top of a page. It always specifies a 
distance either from the top of the page or from the current 
vertical print position. ■ 

File Name The name of a file using standard DOS (or CP/M) 

conventions (e.g. B:Name.Ext). If the file name contains Pfont 
special characters (see below), the name must be enclosed in 
quotes. The ‘B:’ prefix indicates the name of the disk drive 
containing the file to be used. If files are on other than the 
currently logged disk drive, such a prefix must be used. 

Font File Name The name of a file containing the characters of a font. 

Font file names usually have an extension of ‘.fon’ as in 
‘Romnl2.fon’. The ‘.fon’ is optional when input to Pfont: it will 
be provided if it is missing, otherwise this is a standard DOS (or 
CP/M) file name (see File Name). For example, if ‘Romnl2.fon’ 
is on drive B, you only need to type ‘b:romnl2’ (note that case 
is not significant, that is, characters can be a mixture of upper 
and lower case). 

Page Number The number of a printed page. This is usually an 

integer between 1 and 9999. 

Pfont Special Characters Several characters have a special meaning when 
parameters are indicated to Pfont. If you want to use one of 
these characters, but not its special meaning, the character must 
2 q)pear in a quoted string (e.g. or ’’A <k B”). The special 
characters are: 
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7 & ” O < + - , 

See section P.2.5 for a description of each. 


P.1.2 The Embedded Commands ’ 

Fhe descriptions of the embedded commands follow in alphabetical order on 
;he ensuing pages. The commands, grouped according to function, are: 


Font Selection 


Format Control 


Horizontal Motion 

font selection 

b 

break 

h 

horizontal motion 

draft mode 

c 

center 

• 

1 

short horizontal 

underline 

• 

J 

justify 

m 

horizontal mark . 

continuous underline 

k 

justify off 

t 

tab 


r 

right align 

— 

backup 1 character 


w 

word wrap on 




X 

word wrap off 




> 

left indent 




< 

right indent 




Substitution 


Vertical Motion 

Miscellaneous 

Ascii character 

V 

vertical motion : 

reverse field 

string substitute 

1 

line spacing ! 

comment 


n 

mark vertical position 



P 

new page 



q 

conditional new page 
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— Ascu Character 


Ascii Character —- \a 


Specify an ASCII character by its decimal equivalent. 








\a<integer betw^n 000 and 127> 




The \a command will be replaced by a single character 
that is the ASCII equivalent of the indicated decimal 
number. See appendix A8 for a table of decimal—ASCII 
equivalents. 

<Integer between 000 and 127> 

The value must be exactly 3 digits long (e.g. 000, 122). 
The value indicates an ASCII character by its decimal 
equivalent and must be between 0 and 127, inclusive. 

Examples: The a character is: \a065. 

Produces: The A character is: A. 

Errors: If there are no digits following the \a command, or if the 

digits represent a number larger than 127, an error 
message is displayed. If less than 3 digits are specified, 
these digits are processed as if there were leading zeroes 
and a warning message is displayed. 

Notes: • \a can be used to avoid interpretation of -special 

characters — for example: if Control—I, Control—L, 
Control—H are specified by \a009, \a012, \a008 
respectively, then their special 3am^3*iyni meanings will not 
be used. (See \t, \p, and \—). 

* * 

• \a000 must be used if you need to include a ‘null’ 
character in your file. You cannot enter a null character 
in your file without using \a000 as Pfont us^ the true 
null character to indicate an end of an input line and 
will therefore ignore all remaining characters. 


Usage: 


Values: 


• \a026 must be used to include a ‘Control—Z’ (EOF) 
character in your file as ‘Control—Z’ is otherwise treated 
as an end of file marker. 

Use \a to include characters (such as control characters) 
in a text file that are otherwise difficult to enter using 
your text editor or on the command line. 


Suggestions: 











Part P —- Printing with Fonts 

\b —■ Break Break -— \b 


Temporarily end justify and word wrap. 



Usage: When using word wrap (\w), the \b command indicates 


the end of a print line. When \b is encountered, a line 
will be printed whether or not it is complete. Such a 
line will not be justified. See \w for more discussion of 
breaks and word wrap. 

When using justification but not word wrap, \b indicates 
that the line is not to be justified. In this case, the \b 
may be placed anywhere in an input line. 

Values: none 

iiiXamples: • \jllii8 line is not justified, notice the right margin.\b 

Produces: This line is not justified, notice the right margin. 

• XwThis will printXbae two lines using word wrap. 

Produces: This will print 

as two lines using word wrap. 

Errors: none 

Notes: • Several commands (\v, \p, \q, \>, ...) are implicitly 

preceded by a \b command. Likewise, a blank line or a 
line beginning with a space or tab character will be 
assumed to be preceded by a \b. These implicit breaks 
are for convenience and ease of text entry and are 
exactly analogous to the \b command. 

• \b\b\b or \b,^\b... will behave exactly as one \b. 

■ Uggestions: Use \b to override justification and word wrap for special 

lines within groups of lines that are normally justified or 
word wrapped. See \k and \x for turning off justification 
or word wrap for groups of lines. 
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\c — Center • Center —— \c 


Adjust text so that it is centered on the print line. 


ir»r 


•rn 

i; 







iT'; > I'l 


y,\ 

\c 



■MMiM 

•MM 



■SSv: . • • 




dU 



Usage: The \c embedded command specifies text to be centered 

and the horizontal region of the page in which it is to be 
centered. » 


Any text following the \c command up to the first tab 
(\t), horizontal position command (\h), right alignments 
command (\r) or end of line, will be centered. If the 
end of line or the right alignment command are 
encountered, the text will be centered over the entire line 
(i.e. from the left margin for the width of the line minus 
any left or right indentation — see LM and LW 
parameters, \> and \< commands). If a tab or 
horizontal position command (\t or \h) is encountered, 
the centering region will start at the position of the \c 
command and end at the horizontal position that the tab 
specifies. 

If \c is used in word wrap mode, when an end of line is 
encountered on any line that contains a centering 
command, that end of line will force a break. The 
centered text will be printed and subsequent input will be 
printed on subsequent output lines. 

Centering is performed with respect to the left margin, 
line width and current left and right indentation settings. 
Thus, a modification to indentation will modify the 
centering position. 

VsduBS: none 

Exdmplcs: • \cCentered Title 

Produces: Centered Title 

• \h. 125i IXccentered between tabsMiSl INccoiiinn 2\h6il 

Produces: | centered between tabs | column 2 | 

• Left\cCentered\rRight 

Produces: licft Centered Right 

In the first example the centered text is ended by a ^ (end of 
line). Thus it is centered over the entire line width. The second 
example shows two centered strings, one between ,125 and S inches, 
the other between S and 6 inches. If the final horizontal position 
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(\h6i) were not speeifiedf ‘column £* would be centered over the 
entire line (causing overprinting). The final example divides the line 
into S sections: leftf centered and right aligned. The centered text 
is centered over the entire line since it is ended by a right align 
command (\r). , 

A center command cannot be specified within another 
center command (i.e., before a tab or end of line); an 
error message will be displayed and the second center 
command will be ignored. 

Centering will not work properly if the centering region 
specified is too small for the string to be centered, or if 
the end of the region is a horizontal position less than 
the beginning of the region. 

Centering can result in overprinting when the region is 
ended with \r or end of line. 

Commands that force breaks (e.g. \b, \v, \p) will serve 
to mark the end of input to be centered. Because of 
this, be certmn to * place \c after \v if both need to be 
used (for example, \vli\c. not \c\vli..). 

When using word wrap, be careful to know the contents 
of the line to be centered. You may want to start the 
line with a \b (or an implicit break). 

Use in conjunction with HL and FL parameters to create 
centered header and footer lines. Use a combination of 
tabs, horizontal positioning and center commands to 
create labelled tables. 
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\d — Draft Printing . Draft Printing — \d 

Specify horizontal rough drafting modes. 


■‘!*iv!if!fe'*‘'V^Aiik^**'****V'*»‘2w^******W***^%‘r\ 


TTTTTTr*!TTrm^ 




\d<InteKer between 0 and 3> 

? ». W' l ' tt 1 M i j ww♦ I . ii... > r. ' f ' . u. . .n .. i\ m i I :♦.»«. *v.. Tr . yT ii ' . n 


Usage: Place the \d command at the beginning of any print line 

to indicate that line and all subsequent lines are to be 
printed in a new horizontal draft mode. Horizontal draft ^ 
modes represent the maximum number of dots per 
printed horizontal inch and therefore control the quality 
and speed of printing. ^ 

Valu6S: • <Integer between 0 aiid 3> (FX version) 

For +RD 0 to +RD 3 (vertical resolution 216 dpi), the 
modes are; 

0 240 dpi — best quality, 2 full passes per line 

(odd/even dots) — same as 4-RD 0 (which is same 
as —RD) 

1 240 dpi — good quality, 1 pass per line, consecutive 
dots may not be printed — same as +RD 1 

2 120 dpi — 25,000 dots/square inch quality — same 
as -f*RD 2 

3 120 dpi — rough draft quality, consecutive dots may 

not be printed-same as +RD 3 

For +RD 4 to +RD 6 (vertical resolution 72 dpi), the 
modes are: 

0 120 dpi — good quality, 1 pass per line — same as 

+RD 4 

1 120 dpi — rough draft quality, consecutive dots may 
not be printed — same as +RD 6 

2 60 dpi :— same as +Rp 6 

■4 

• <Integer between 0 and 1> (MX version) 

For +RD 0, the modes are: (vertical resolution 216dpi) 

0 120 dpi — best quality —— same as +RD 0 (—RD) 

1 60 dpi — rough draft quality — no corresponding 

+RD mode 


For 4-RD 1 and +RD 2 (vertical resolution 72dpi), the 
modes are: 

0 120 dpi — good quality — — same as +RD 1 

1 60 dpi — sandpaper quality — same as +RD 2 












































Ebcamples: 

I 

( 

Produces: 

Produces: 

Produces: 

t 

Produces: 


Errors: 


Notes: 


Suggestions: 
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(vising +RD 0, FX version) 

XdODraft kode 0, nopial printing. 

Draft mode 0, normal printing. 

\dlDraft node 1. * 

Draft mode 1. 

\d2Draft node 2. 

Draft mode 2. 

\d3Draft node 3. 

Draft mode 3. 

Notice that the word ^Produces” is also printed in the draft mode. 
Draft mode can only be set by print line, it cannot be changed 
within one line. 

If an improper draft mode is selected, the mode will not 
be changed and a warning message will be displayed. If 
a change of draft mode is attempted anywhere on a line, 
then the entire line will be printed in the last draft mode 
specified on the line. 

\d is preceded by an implicit break since an entire line 
must be printed in one draft mode. 

\d can only affect the horizontal draft modes since the 
fonts are loaded into memory using a specific vertical 
draft mode before Pfont starts to print. 

Use the draft mode command to print different lines at 
different dot densities to increase speed and/or create 
special appearances. Try printing larger fonts at higher 
draft modes and thus higher speeds and smaller fonts 
using the best quality modes. 
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\f — Font Selection Font Selection — \f 


Specify the font to be used for all printing until the next \f command. 



Usage: Place the \f command anywhere in your text file. All 


subsequent text until the next \f will be printed in the 
font represented by the symbol following \f. 

• \f<digit> indicates the number of the font to use — see 
FO parameter and the table below. The <digit> must^ 
be between 0 and 9 for CP/M users but MSDOS users 
may specify ‘a’, ‘b’, ‘c’, ‘d’, ‘e’ for fonts 10 thru 15 when 
using Fancy fonts. 

♦ 

• returns to the previous font selection (i.e., the 
numbered font in effect before the previous \f command). 
Font 0 is considered the previous font if there have been 
no previous font changes. 

• \ff indicates that the high-quality, fancy fonts, are to be 
used (this is the normal, initial setting). 

• \fn indicates that fonts native to the printer are. to be 
used. (See the list below for details). Fancy fonts and 
native printer fonts can be combined in the same 
document, but not on the same print line. 

Values; . <Digit> 

For printing, the digit between 0 and 9 

corresponds to a font specified using the +FO parameter. 
MSDOS users may specify ‘a’, ‘b’, ‘c’, ‘d’, ‘e’ for fonts 10 
thru 15. Font 0 is the first font specified by +FO, font 
1 the second, etc. That is, if the following command line 
is used: 

Pfont Tftxt.ff -t-FO RoBnl2 RoBnl4, 

then, ‘\fD’ corresponds to ‘Romnl2’ and ‘\fl’ corresponds 
to ‘Ronml4’. Pfont initially uses font 0* imtil changed by 
- a \f command. 

For printing using native printer fonts (i.e. \fn), the font 
numbers select from a different set of fonts. The 
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correspondence of numbers to fonts for the Epson MX, 
FX, RX and the IBM Graphics printer is: (this 
correspondence can not be changed) 

Font Number Epson MX,FX or IBM Font 

0 Normal 

1 Compressed 

2 Expanded 

3 Compressed/Expanded 

4 Normal Italics 

6 Compressed Italics 

6 Expanded Italics 

7 Compressed/Expanded Italics 

8 Normal Emphasized 

9 Expanded Emphasized 

• P 

Select the previous font (font 0 if no previous font). 

• f or n 

Switch between high quality, Fancy Fonts (f) and Native 
printer fonts (n)! The current font number remains in 
effect when switching between high quality and native 
fonts. 

Examples: (using Pfont parameters: +FO Romnl2 Romnbl2) 

• \fOThis is \flwondarlul wtatherXfp. 

Produces: This is wonderful weather. 

• XfnNfOThis is \f iwondarful waatharXfp. 

Produces; This is wonderful weather. 

Where \f0 refers to RomnlB and \fl refers to Romnbl2, \fp, in 
this ease, is the same as \f0. Notice how \fn switches to lower 
quality, native printer fonts. Remember to switch back to Fancy 
Fonts with \ff at the beginning of the next line. Either \ff or \fn 
must be used for an entire line. 

Errors: • The digit following \f must correspond to a font specified 

with the +FO parameter (if not using native printer 
- fonts). If there is no correspondence, a message will be 
displayed and no font change will take place. Most fonts 
define a similar set of characters (alphabet, numbers, 
punctuation, etc.). 

• If you select a character for printing that is not defined 
in the current font (see Appendix A2), nothing will be 
printed. An error ‘message is not displayed in this event. 
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and the resulting printing will have several missing 
characters. 

\fn and \ff must be the first commands processed on any 
new print line. If either of these commands is issued at 
other than the beginning of the line, the entire line will 
be printed in the type of fonts specified last on the line, 
horizontal and vertical formatting will not work properly, 
and a warning message will be displayed. When usin*^ 
word wrap, it is recommended that you precede \ff or 
\fn with \b to force a line break. 

I 

If, when using \fn, a font number is selected that does 
not correspond to a \ff font number available for use, 
then a subsequent \ff command will display a warning 
message automatically select font 0. 

When you change fonts, you change the definition of all 
characters including spaces. Thus, the width of a space 
may vary depending on the current font. For example, 

\fOThis isXfl a test.XfO 
may be spaced differently than: 

\fOTliiB is \fla test.XfO 

f, n and p may be upper or lower case characters. 

The amount of vertical space occupied by a printed line 
depends upon the tallest and deepest fonts used on the 
line. Pfont attempts to maintain uniform spacing 
between lines, but cannot always do so (see section E.2). 
When the requested interline spacing is not possible, a 
message is displayed at the end of all printing. On 
printers that allow reverse paper motion, S^tyni will 

remove this extra vertical space by rolling back the 
paper. (See +RV parameter). 

The height of a blank line is determined by the current 
font. The placement of the \f command determines the 
spacing. For example, headlines iii large fonts should be 
typed as ‘\flHeadline\fD’ rather than putting the \f0 on 
a subseqent line. See \v for finer control of vertical 
white space. 

I 

Native printer fonts and Fancy Fonts cannot be used 






Suggestions: 
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within the same print line. 

• \: used in conjunction with native printer fonts produces 
‘double—strike’ print. 

I 

• Use \f commands throughout text to print with multiple 
fonts for emphasis, super and sub—scripting, section 
headings, special symbols, etc. 

• Use \fp in substitution strings when font switching is to 
be done and then returned to the font in effect before 
the substitution string was used. For example, to create 
a string to print 

+SU "\f3Fancy FontNfp" 

would produce 3*(yni^ when \s0 was used, and then 

switch back to the font in effect before the substitution 
string. 

• Use a combination of \ff and \fn to print titles or 
letterheads with high quality Fancy Fonts and the 
remaining sections of your documents with high speed, 
native printer fonts. 
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\h — Horixontal Motion 


Horizontal Motion — \li 


Move the print head forward or backward on the current print line. 


iiiiiiSi Qj. — option><iiorizontai \hm<i)iKit> 

! ii r r. ' i ' .u ' .pj;fii ' ii .nil.jm. ^ n I rr mivTm * nmu ' . i t ^viu.w. i ti», 4 ij.i♦ ' i r wiuvum i .n,..iinir f U TtT^WW^Tymr^t i i mim Ttiy rw yfW ^ Tii n I 'fw 


liVi >V*i* 


Usag6: The \h command can be placed anywhere within text to 

position the print head. It can be used to move forward 
or backward, to cause overprinting or to position outside^ 
of an indented printing region. The positioning can be 
absolute with respect to the Left Margin (LM, not 
indent), or can be relative to the current placement of 
the print head. Instead of specifying a Horizontal 
Measure, \hm<Digit> can be used to position the print 
head at a previously defined mark (see \m). 

Values: • <Horizontal Measure> 

The Horizontal Measure must evaluate to a distance 
between 0 (left margin) and the current line width (see 
LW parameter). This allows for positioning on the entire 
print line, including outside of indented areas of text. 
All values must include a specification of a unit (i,c,d,u) 
immediately at the end of the number (e.g. \h3.4i). 
Values may be preceded by either a ’ or ‘+’ to 
indicate motion backward or forward relative to the 
current print position. Absolute measures are based on 
the left margin (independent of indentation). The print 
head may be positioned within an indentation area (that 
is, to the left of the normal printing area) .to form 
outdented lists and other special effects. Positioning past 
a right indented' region will cause a warning menage to 
be displayed if not using word wrap, but can be used. 
Positioning past the right indented area is not 
recommended when using word wrap — this may result in 
the generation of a new line. 

• m<Digit> 

The digit must be between 0 and 9 and must have been 
previously defined by a \m<Digit> embedded command. 
The print head will move to the referenced position on 
the line. 


Ex3*lIipl6S: • Start\li2ileft aargin + 2 inches. 

Produces: Start , left margin + 2 inches. . 

• Start hereXh’i* 1.751 and leave a 1 3/4 inch gap. 

Produces: Start here and leave a 1 3/4 inch gap. 
































> Produces: 

Errors: 


Notes: 


Suggestions: . 
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This is a NaCaarked line, see the line-up? 

VhaOX narks the spot! 

This is a marked line, see the line—up? 

X marks the spot! 

\. 

Attempt to specify a horizontal measure outside of the 
current printing range (determined by +LW and +LM 
settings) will display an error message and will cause no 
change of the print head position. If the position is 
within the right indentation region (see \<), a warning 
message will be displayed, but the print head will be 
positioned as requested. Positioning within the left 
indentation region (see \>) is ok. 

The \h command can be used to cause characters to be 
overprinted. If this occurs, and is not intended, it is 
likely that a horizontal position less than the current 
print head position, was specified. 

If horizontal motion is used in conjunction with 
justification (\j), then justification will begin after the 
last horizontal niotion command on a line. Use \i to not 
affect justification in this way. 

A horizontal motion command at the beginning of a line 
does not cause a word wrap break, so if word wrap is on 
and you want to line up some text under a mark point 
on another line of text, then the line containing the mark 
point should end with \b. 

\h can be used in place of a tab and thus allows the 
simulation of multiple ‘tab’ stops within a text file. 

Use \h to create outdented lists. That is, you can 
explicitly place text within the indent region using \h 
after setting an indent with \> or \<. 


o 
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\i — Relative Horizontal Motion Relative Horizontal Motion — \i 


Specify short horizontal motion, forward or backward from the current print 
head position. 



Usage: The \i command will cause the print head to move 

forward or backward the specified number of units. If tto 
‘+’ or ’ is indicated, a ‘+’ is assumed. \i differs from 
\h since it is relative only, limited to a short distance, 
and most important, it does not affect justification n*or 
does it serve to end a region such as those used for 
centering and right aligning. (See \c and \r). 

Values: <Horizontal Measure> 

The value specifies the distance to move the print head 

forward or backward. It can be specified in any available 
unit,, but must result in a number of printer dots 
between 0 and 255 (1 to 2 inches depending upon the 
printer). 

E/Xamples: • There is 1 inch between Ms: 

Produces: There is 1 inch between |’s: | |. 

• A 2 and 1/2 inch long blank line:\_\ili\ili\i .5i\_ . 

Produces: A 2 and 1/2 inch long blank line: _ 

Errors: none 

Notes: This works with only approximate accuracy for native 

font printing. 

Suggestions: • If you wish to squeeze slightly, more characters on a line 

but do not want to adjust the line width, you may 
replace a space character with a \i command to reduce 
the size of the space character. 

• Use \i instead of \h for short horizontal moves whenever 
\h would cause undesired side effects, such as when used 
on a justified line or within centered and right aligned 
strings. See \h command. 

** • \i can be used in conjunction with continuous underline 

(\_) to create horizontal lines as in the example above. 
Since \i is limited to short movement, you can combine 
several \i commands to achieve the desired length. 
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j — Justification On 


Justification On —- \j 


furn on justification. Each space character in the printed line will be 
xpanded so that the right edge of the text is even with the right margin. 









\j 


sv.v.’Xv. 












Jsage: Place the \j command anywhere in your text file. All 

subsequent text (including the line in which \j appears) 
will be justified until turned off by \k, or temporarily 
overridden by \b, \c or \r. 

J alues: none 


iiXailiplcS* NjTliiB line is justified, notice the right margin. 

Produces: This line is justified, notice the right margin. 

Errors: none 


'Totes: • Justification is initially off. 

• Only spaces following the last tab or \h command in a 
line are expanded to provide justification. Therefore the 
\h command affects justification, but the \i command 
does not. Also, leading spaces on a print line are not 
justified. 

• \b, \r (right align) and \c (center) temporarily override 
justification for the line on which they appear. 
Justification will again be in effect on the next print line. 

• When using word wrap, justification is temporarily 
overridden by the above commands, as well as by implicit 
breaks, such as \v, \p, \>, lines beginning with a space 
or tab character, and blank lines. 

• Lines which require spaces wider than approximately 1 
inch each for proper justification will not be completely 
justified (justification would not look good in these cases). 

• Lines which exceed the maximum line width will not be 
justified. 


.• Pfont does not do letterspacing . That is, it does not add 
space between the letters of a word, but only between 
words. If letterspacing is absolutely necessary, use the \i 
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command to explicitly preform the letterspacing. 

A combination of justification (\j) and word wrap (\w) 
produces nicely aligned text. If very long words are 
combined with short lines, justification may leave larger 
than desired gaps. In this case, you may want to insert 
your own hyphenation to improve the appearance of your 
printed document, or choose not to use justification. 

■ I 

All implicit breaks, and of course the explicit \b 
command, force a temporary end to justification when 
word wrap is enabled. This allows you to easily print* 
paragraphs and other sections of documents without 
needing to explicitly turn on and off justification. When 
not using word wrap, \b only, temporarily ends 
justification. 
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\k — Justification Off Justification Off — \k 


Turn off justification. 



Usage: Place the \k command anywhere in your text file. No 

subsequent text will be justified imtil a \j command is 
encountered. The line in which the \k appears will not 
be justified. 

Values: none 

NkThis line is not justified, notice the right margin. 

This line is not justified, notice the right margin. 

none 

Notes: This command has no effect on word wrap. 

Suggestions: Use a combination of \j, \b and \k embedded commands 

to control justification. 


Examples: 

Produces: 

Errors: 
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—- Line Spacing Line Spacing — \1 

Set the interline spacing. 










i \1<+ or — optionXVertical Measure> 


v:;:v:v:* 

Ill 



Usage: 


Values: 


The line on which the \1 command is placed will be 
printed preceded by the indicated amount of vertical 
white space. » 

<Vertical Measure between —425 and 425 inches> 

The amount of vertical white space to appear before the ^ 
current print line and all subsequent lines. The value 
must be a real number followed by a unit specification. 
The value may be preceded by a plus or minus to add 
to, or remove from the current setting of line spacing. A 
vertical measure without + or — will set the line spacing 
to exactly the indicated value. The initial line spacing is 
set to the value of the +SP parameter. 


The measure is the distance from the bottom of one line 
to the top of the next. The bottom of a line is the 
location of the lowest font on the line independent of the 
characters actually typed on the line. 

Cxd^mplcS^ Ihift is the first line. 

\1.6iTliis line is preceded by 1/2 inch of white space. 

Produces: This is the first line. 


Errors: 


Notes: 


This line is preceded by 1/2 inch of white space. . 

Line spacing greater than the current page length (see 
+PL parameter) will force a new page between each line. 
This would normally be undesirable, and would likely be 
the result of an error. 

• The interline spacing begins with the setting specified by 
the +SP parameter. The \1 command performs the same 
function as 4-SP, however it can be used multiple times 
within a document to alter the interline spacing. 

• The standard interline spacing is .045 inches (3 dots on 
Epson MX and FX type printers), 

• \1 causes a break when used in word wrap mode. 









Suggestions: 

k. 


O 
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Use \l to set off special sections of text. For example, a 
quotation may be ^ printed indented and with less than 
normal interline spacing. 
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— Horizontal Mark . Horizontal Mark — \m 


Viark the current horizontal position of the print head. 



Usage: Place the \m command anywhere in your text to 


remember the horizontal position at which the next 
character will be printed. Up to 10 horizontal marks can 
be set and used in a document. Each of the marks can 
be reset as often as desired. 

<Digit between 0 and 9> 

A number between 0 and 9 used to reference the mark. 
Thus, 10 marks are possible. See the \h command to 
use the marks set by the \m command. 

* 

XmOThifl is a wall Xmlaarked lina\iB2. 

\hmltMark l\hffi2tMark 2\hm0tMark 0. 

This is a well marked line. 

|Mark 0. jMark 1 tMark 2 

Errors: Missing or non-digit values will cause the command to 

be ignored and a warning message displayed. 

Notes: • The position at which the next character would be 

printed is marked — this is considered the current print 
head position. 

• See \h command to make use of marked positions.* 

Mlggestions: • is a typesetting system as well as a printing and 

word processing package. Most of the fonts are 
proportional and characters printed on successive lines 
normally do not line up with one another. The marking 
facility is therefore useful in lining up text. 

• The \m command is useful in lining up columns of text 
and or numbers. As depicted in the example above, one 
or more positions in a line may be marked and then used 
in subsequent lines. Try this command for lining up 
numbers, for overprinting, etc. 


V^alues: 


Examples: 

Produces: 
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\ii — Vertical Mark Vertical Mark — \ii 

Mark the current vertical position from the top of the page. 



Usage: 


Place the \n command anywhere in your text to 
remember the vertical distance from the top of the 
current page to the current print head location. Up to 
10 vertical marks can be set and used in a document. 
Each of the marks can be reset as often as desired. 


Values: <Digit between 0 and 9> 

A number between 0 and 9 used to reference the mark. 
Thus, 10 marks are possible. See the \v command to 
use the marks set by the \n command. 


E/Xaniples: • \n3The vertical position of this line is marked. 

The position of the top of this line from the top of the page is 
marked and can be referenced by \vm8, 

• \w\j\<3.25i\nOThis is an example of printing two columns of 
text for an insert within a page of otherwise one large 
column of text. It is also possible to print entire pages 
with two or more columns» however you are responsible for 
performing explicit pagination, headers and footers. 
\vm0\<0i\>6.25iThis is the second column. See how it lines 
up with the first column due to the use of a combination of 
vertical marking (\n> and vertical motion C\v). Also notice 
the use of the left and right indent commands C\>, \<) to 
determine the width of the columns. \<0i\>0i 

Produces: 

This is an example of This is the second 

printing two colurtms of column. See how it lines 

text for an insert within a up with the first column 

page of otherwise one due to the use of a 

large column of text. It combination of vertical 

is also possible to print marking (\n) and vertical 

entire pages with two or motion (\v). Also notice 

more columns, however the use of the left and 

you are responsible for right indent commands 

performing explicit (\>, \<) to determine 

pagination, headers and the width of the columns, 

footers. 


i/iTors: 


none 














Notes: 



Suggestions: 
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Negative vertical motion (reverse paper feed) is only 
available for . printers that provide this feature (e.g., 
Epson FX80). 

The vertical position is marked from the top of the page 
to the top of the inkable area for the current print line. 

\n marks a vertical position from the top of a page. 
This position will be marked for all pages. The position 
is not a combination of page and vertical position, it is| 
position only. 

Useful in printing multiple columns with printers that can 
reverse paper feed. As shown in the example above, 
mark the start of the first line of the first column on a 
page or in a table, then return to that mark to print 
each subsequent column. 

Can be used to line up text at the exact same vertical 
location on many different pages; as used in multiple, 
overlay transparencies. 
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\p — New Page New Page — \p 

Begin printing on a new page. 



Usage: The \p command causes the current page to be ended 

(footer will be printed) and the next page to be printed 
(starting with the header). If not using word wrap, 
regardless of where the \p appears in a line, the entire 
line will appear on the new page. Using word wrap, \p 
causes an implicit break and thus ends the current print 
line. 

Values: none 

Examples; VpThia line iB on a new page. 

This is hard to demonstrate on a single page, Pfont ends the 
current page, starts a new page and prints: This line is on a new 
vase, on the first line of the new page. 

Errors: none 

Notes: • The Process Form Feeds (PF) parameter does not affect 

\P- 

• Control—L is a synonym for \p, but it is affected by the 
PF parameter. See PF parameter to ignore Control—L 
characters. Use \a to make use of Control—L as a 
printable character (or use —PF). 

• \p is implicitly preceded by a break. 

suggestions: Use \p to assist in generating desired pagination; e.g., 

forcing chapters and figures to begin on a new page, thus 
avoiding page breaks in the middle of figures. See \q for 
conditional new page. 





































> o 
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iq — Conditional New Page Conditional New Page — \P 


3egin printing on a new page if the indicated vertical space is not available 
)n the current page. 



CJsagc: Indicate a vertical measure. Pfont will determine whether 

the amount of space you indicated is still remaining^ 
between the current vertical print head position and the 
r. top of the bottom margin area of the page. K the space 

remains, the \q command will have no effect (except ^ 
causing an implicit break); if the space is not available 
on the current page, the \q command will cause the 
footer of the current page to be printed and then will 
begin subsequent printing on a new page. 

« 

Values: <Vertical Measure between 0 and 425 inches> 

A real number indicating the amount of space that must 
be remaining on the current page if the page is not to be 
ejected. The number must be ended with a unit. 

Examples: \q2.5i 

\p if less than g 1/2 inches of vertical space left in printing area 
of page, otherwise nothing. 

Errors: none 

Notes: • \q command forces an implicit break in word wrap mode 

regardless of whether a page is ejected. 

' • 

• \q with a Vertical Measure larger than the current page 

length is equivalent to \p (since there will never be the 

requested amount of space left on the page). 

Suggestions: Use \q command to ensure that new sections of text will 

start on a new page if there is not sufficient room for 
them on the current page. 
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\r Right Alignment 


Right Alignment 



Align a string of - text so that it is flush with the right margin or a 
specified horizontal position. 





HB|i| 


>oww»3w38w888888 era 




Usage: All characters to the right of the \r command and 

preceding the next new line character, tab or horizontal 
positioning command will be printed so that they are 
fiush right with the right margin (in the case of new 
line) or with the horizontal position specified by tab or 
\h. 


Values: 


Examples: 

Produces: 

i 

Produces: 


Produces: 


<any textXnew line, break, \h or tab> 

Follow the \r by any text. The region is ended by the 
end of the line (new line character), by any break, 
implicit or explicit, by a horizontal position command 
(\h) or a tab. 

Laft of paga\rright aligned. 

Left of page right aligned. 

\rAligned at 5 inches.\li5i 

Aligned at 5 inches. 

\r42.\h3i72 

\r6.\h3i2974 

42.72 

5.2974 


Errors: Centering and right align within a right align statement 

are prohibited; an error message will be displayed, and 
they will otherwise be ignored. 

Notes: If using word wrap (\w), the text from the \r command 

to the next \b, new line, or implicit break command (e.g. 
Xv, Xp, Xq) considered to be the text to be right 
aligned. 

Suggestions: . \r is useful in formatting header lines (HL) and footer 

' lines (FL). The command is also useful in lining up 
colunms of variable width numbers as shown in the 3"^ 
example above. 

• Consider using a fixed width font instead of \r for 
creating tables of aligned columns. 



























) 


o 
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V| — — Substitute , Substitute — \b 

Insert the current page number, file name or a pre—specified string in the 


\^Ti ®r \si or \s^l^iglt^ 



Values: 




-i'’, 


The \s command will be replaced in the text by a string 
of characters determined by the character following \s** 
The substitution takes place before justification or any 
other processing of embedded commands. 

i 

# 

If the character following the \s command is then 
the entire command (\s#) will be replaced by the 
number of the current page. 


If the character is T, then the command (\sf) will be 
replaced by the full name of the file currently being 
printed. 


• <Digit> 

If the character is an integer between 0 and 9 and there 
is a corresponding substitution string specified (see 
Substitution +SU), then the entire command will be 
replaced by that substitution string. 

ExamplcSC • nils is page \b#, file Nsf. 

Produces: This is page 35, file ffmanp2b.man. 

• (using Pfont parameters: +SU ”String 1” ’’page is Xs#”) 
Substitution occoirs here: \sl and here: \b0. 

Produces: Substitution occurs here: page is 35 and here: String 1 

Errors: • Substitutions can be indicated within substitution strings 

(see second example above). It is possible that a 
substitution string attempts to substitute itself (recursive 
substitution). A line length exceeded error message will be 
displayed and subsequent program behavior will be 
unpredictable. Immediately exit the program using 
Control—Z in this case (CP/M, use Control—C). 

•»« 

• If the number of a nonexistent substitution string is used, 
an error message is displayed and the substitution request 
is ignored. 
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• When not using word wrap, be careful that lines do not 

exceed the line width after substitution occurs. 

# 

• The T in ‘\sf may, appear as either an upper or lower 
case character. 

• Any embedded commands may appear in a substitution 
string and will be processed after substitution. 

The embedded command \s^ is essential in printing the 
page number in the header or footer line. See HL and FL 
for details. Substitution strings can be used to fill in 
variable fields in form letters (one line at a time), to 
include frequently typed words or to represent a sequence 
of other embedded commands. When defining a 

substitute string (using +SU) that changes fonts, consider 
using \fp rather than a specific font number to switch 
back to the font that was in effect before the substitute 
string was used. 
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it Tab . 

, -V .V i ' 

■; > ^ 

Horizontal motion to the next tab stop. 


Tab — \t 




.-’'I' - 

Usage: 


?"'=> ■ 
i : ■. . *.. 


Values: 

Examples: 


Produces: 


Errors: 


Notes: 




Whenever the \t command (or its Control—I synonym) is 
recognized in the text, an attempt will be made to find 
the next available tab stop (see Tabs parameter). If 
found, the print head will be positioned at the tab stop, 
otherwise the tab will be ignored. 

none 

(using Pfont parameter: +TB 4i) 

Tab coningVtfirst stop. 

; Tab coming first stop. 

The word first appears 4 inches from the left margin. 

If there is no remaining tab to the right of the current 
print position, an error message is displayed and the tab 
command is ignored. 

• \t and Control—I (the normal ’’Tab" key on your 
keyboard) are synonyms and can be used interchangeably 
(with the exception of parameter strings such as* H-HL 
and +SU, where \t must be used). 

• Tabs can only move the print head forward (towards the 
right). See \h or \i for backwards horizontal motion, 

• 

• Tab stops cannot be changed within a document; use \h 
or \i instead. 


• All tab stops are relative to the left margin, not the left 
indent location. 


• A tab issued while to the left of an indented left margin 
will cause the print head to move directly to the 
indented left margin — regardless of any tab stops 
between the current position and the indent. 

** • Left indent does not change tab settings in any way 
other than described in the preceding note. 

• Tab stops work similarly to those used by mechanical 
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typewriters; the current position of the print head and 
the tab stop settings will determine the extent of the tab. 
Different sized characters and different numbers of spaces 
may produce different results. 

• Control—I or \t at the start of an input line will force 
an implicit break when using word wrap. In this use 
only, they are equivalent to \b\t and \bControl—I. 

• Tabs affect justification. Only spaces following the last 
tab on a line will be used to adjust the length of a 
justified line. 

Suggestions: Use a combination of tabs and horizontal motion (\h, \i) 

to help line up text in columns and tables. 
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1 — Underlining 


Underlining 



urn on and off underlining of text. 






Place the \u command anywhere in your text file. All 
subsequent text will be underlined until another underline 
command (\u or \_). Thus, \u is a toggle. Each time 
it appears in text underlining will be turned off if it was 
on, or on if it was off. 


The continuous underlining conunand (\_) is similar to 
\u, however it will underline white space, whereas \u will 
underline only characters. (See embedded command). 


f alu6S: none 

iiXamplcS! • Some of this is \u\mderlined text\u. some is not. 
Produced: Some of this is underlined text , some is not. 

• \_Fully underlined including spaces.\u 
Produces: Fully underlined including spaces. 


Crrors: • Make sure to turn off underlining before switching 

between fancy fonts and native printer fonts (see \ff and 
n); extraneous lines may result. 

• When using native printer fonts (see \fn) if underlining 
remains on between printed lines, the left margin will be 
underlined. 

fotes: • White space is not underlined for Fancy Font fonts, only 

characters with ASCII codes other than 32 are underlined 
(see example above). Continuous underlining, including 
spaces, can be achieved by using the \u command, as 
shown by the second example above. 

• Notice that \u can be turned of by another \u or by \_. 
Therefore, \u and \_ cannot be used at the same time. 

Uggestions: Don’t forget to turn off underlining (by using another \u 

or \_). If you forget, the remainder of your text will be 
underlined. 
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— Vertical Motion Vertical Motion 



Specify the amount of white space to precede the current line, or 
movement of the paper to begin printing the specified distance from the 
top for the page. 




or - or \vm«liidt::^ 









Usage: To position the print head a specified distance from the 

top of the page, use \v with an absolute number of 
units. For example, \v4i will begin printing the top of 
the current line 4 inches from the top of the page. The 
use of a relative positive measure (e.g. \v+.25i) will leave 
exactly the specified amount of white space between the 
bottom of the previous print line and the top of the 
current print line. Negative distances (relative to the 
current location of the print head, are only possible with 
printers that allow backwards paper motion. 


gi- A 


K * 


\vm<digit> will position the top of the current print line 
to the indicated position, however this is only usable for 
printers that allow reverse paper motion (such as Epson 
FX80). 

Values: • <Vertical Measure between 0 and 425 inches> 

The value can be absolute, or relative, but must be less 
than 425 inches when evaluated. 


• m<digit> 

Move directly to the position marked by the indicated 
vertical mark (\n<digit>). 

Examples: Thar, is 1/2 inch of white space between this line 

\Y+.6iand this line. 

Produces: There is 1/2 inch of white space between this line 


and this line. 

_ 

irrrors: An attempt to move the paper outside of the possible 

range of motion will cause the \v command to be ignored 
and an error message to be displayed. 

^Otes: • If \v appears on the first line of a printed page it will be 

ignored unless the new page was explicitly requested by a 
\p command, a Control—L character, or if it is the first 




Suggestions: 
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page of a document. 

\v can cause a new page to be printed. In this case any 
unused portion of the distance specified with \v will be 
discarded and \v is identical to \p. 

Remember that interline spacing refers to the distance 
between the bottom of one line (including descenders) 
and the top of the next. Whether or not the actu^ 
printed line contains descenders or ascenders doesn’t 
matter; it’s the overall height of the font that matters. ^ 

Vertical motion to a mark set on a previous page will 
position the print head the previously marked amount 
down from the top of the current page. 

Use the \v command to temporarily override the value of 
the Interline Spacing parameter (SP). The command is 
useful for specifying the exact amount of white space to 
be left before paragraphs, sections, examples and in 
tables. You may leave a blank line in your text to 
achieve vertical white space. \v provides this same 
capability, but with greater control over the amount of 
white space. 

Remember to specify \v+... when leaving extra vertical 
space between lines; without the ‘+’ an absolute position 
results. 
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—. Word Wrap On Word Wrap On — 

Enable moving of words between lines to automatically fit line length. 



Usage: Place the \w command anywhere in your text. The line 

on which \w occurs and all subsequent lines will be word 
wrapped. That is, the end of line in your text input will 
be largely ignored. Pfont will read words from your 
input text and fit as many words as possible on each 
output line. 

There are a variety of ways to stop word wrap or to 
temporarily ‘override’ this feature. \x will turn word 
wrap off (the built-in setting). \b, any implicit break 
(e.g., \v,\p,\q), an input line beginning with a space or a 
tab, or a blank line will cause the previous line not to be 
word wrapped. Thus, paragraphs can be separated by a 
blank lines and/or the first line of a paragraph can be 
indented to automatically create the desired effect 
between successive paragraphs. This provides a natural 
means of typing text to be formatted and printed. 

Values: none 

Examples: \wTlie8a linaa ara to ba conbinad 

notica bow tbay print in a diffarant aannar than thay appaar 
in tha input taxt. 

Produces: These lines are to be combined notice how they print in 

a different manner than they appear in the input text. 

Errors: Improper ‘long line splits’ may occur if very long words 

(longer than approximately 20 characters) are frequently 
used without using new lines periodically within 
paragraphs (every 200 or so characters). This is 
extremely rare, since words are usually shorter than 20 
characters. 

Notes: • Pfont behaves rather differently when word wrap is 

enabled. The implicit breaks become operational for both 
word wrap and for justification. This is a significant 
difference and allows text to be entered without the use 
of any special conunands; specifically \b is not' often 
required. There ^e no implicit breaks when not using 
word wrap. 
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Word wrap will adjust lines to be the length of the 
current margins and indentation settings. When 

indentation is changed, word wrap automatically reflects 
the new effective line length. 

New line characters are normally turned into single 
spaces; however, if immediately preceded by or ‘!’, 

new line characters are turned into double spaces to 
separate sentences. 

Pfont removes all trailing spaces from lines input from 
files. In this way, no groups of extra spaces should 
mistakenly appear in output. However, if you place more 
than one space between words within a line, the extra 
spaces will not be removed by Pfont. 

You can type entire paragraphs, sections or an entire 
document without using any new line characters to mark 
the end of input lines. 

Lines will be broken for wrapping immediately before a 
space (or new line) character. 

It is recommended that \w be issued at the start of a 
document or the start of a sequence of normal 
paragraphs. 

\w may be used with or without justification (\j). 
Justification is independently enabled and disable by the 
\j and \k commands respectively. 
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\x — Word Wrap Off 


Word Wrap Off — \l 


Do not move words between lines (the built-in setting) 


^ , r 


T< 






' HM I .. ♦ i nn . tif u Ti ' i ♦ r , " H . 1 .1. i. i. 1 


Pf 




5x 


N%vXM>VVXvtvt*X;>XjX»X»X»X<*X^^ 




i ' nin T j ' i.m T 




?P 


Usage; 


Values: 


Ebcamples: 


Produces: 


Errors: 


Notes: 


Suggestions; 


The line on which \x is encountered and all subsequent 
output lines will be printed as they appear in the input 
text. That is, line endings will appear exactly as they 
are in the input text. Lines that are too long to fit 
within the margins will be chopped off and only the 
portion fitting on the output line will be printed. 






Additionally, implicit breaks will no longer serve to 
temporarily end justification — the explicit \b break must 
be used. 


none 


XxThis line is not word wrapped. 

The previous line is very short as is this one. 
This line is not \vord wrapped. 

The previous line is very short as is this one. 


‘Line length exceeded’ messages will be displayed for all 
lines that are longer than the current line width and 
indentation. These lines will be truncated if using 
^®w’s (\ff) or ‘wrapped’ as to overlap themselves if using 
native printer fonts (\fn). 


This is identical to the formatting mode available in 
^<vni versions prior to version 2.0. 


It is useful to turn off word wrap when printing tables, 
letter salutations or other groups of text where ‘as is’ 
appearance is desired. 


U 


''A 




E 


E 


'■>7 


I 


< 
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•i— Reverse Field Printing 


Reverse Field Printing — \: 


>ggle between normal printing (ink forming characters) and reverse 
Inting in which a black background is printed with non—black areas 
ijpiaaring as printed characters. 





TTT 



















Place \: anywhere in your text. All subsequent printing 
will appear in the reverse field until another \: command 
is encountered in the text. Normally, printing will be 
black (or ink color) on white (or paper color). For the 
Epson MX,RX and FX printers, if a native printer font is 
in use, reverse field will enable and disable double strike 
printing. 


allies: none 


xamples: 

■■1 I ■! 

’ ' Produces: 


(for fonts) 

and now nornal. 

This and now normal. 

(for naSiv^pnnfer fonts) 


\fnThiB \:is raversaX: and now normal 


■'! ;i. 


IS reverse and 


; 'iOW nO! . 


rrors: • This doesn’t work particularly well for fonts. 

The reverse field characters tend to be overwhelmed by 
the reverse field itself. It works best for large, thick or 
bold characters. 

• Different height characters produce different height 
backgrounds. 

Otes: Try using this with rough draft mode for slightly better 

appearance. 


Iggestions: This can be used to produce thick, dark lines or perhaps 

with special characters as a visual separator. You are 
pretty much on your own with this one, however; let us 
know if you find a good application. 













Part P — Printing with Fonts 


;— Backup Character 


Backup Character — \. 


- ' • ^ 

'Cause the print head to move backwards by the width of the last printed 

’character. • 1 


Usage: 


_ i 

Place \— anywhere in your text to cause two successive 
characters to be overprinted. When \— is encountered, 
the print head will be moved backwards by exactly the 
width of the most recently printed character. 


Values: 


none 


E/X311ipl6St One way to print reenneX-’ or Hela^N-ut. 

Produces: One way to print resumfe or Helmut. 

Errors: none 


Notes: • The ‘Control—H’ character embedded in text can be used 

as a synonym for the \~ command. Depending upon the 
text editing program you are using, it may be difficult to 
actually insert* a ‘Control—H’ character in your text, 
however. 


• (Notice that \— is the ‘minus’ sign). 

Suggestions: • Use this for overprinting single characters for accents as 

shown above and for simultaneous super— and 
sub—scripts. (Either order of characters is possible). See 
also the \i, \h, \m commands and the use of negative 
character margins in Efont. 

• Use \i to finely adjust overprinting of characters having 
different widths. 
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Continuous Underlining 


Continuous Underlining — \_ 


. IHirp on and off continuous underlining of text. 



PUgage: 


Place the V_. command anywhere in your text file. All 
subsequent text will be underlined until another underline 
conunand (\_ or \u). Thus, \__ is a toggle. Each time*, 
it appears in text underlining will be turned off if it was 
on, or on if it was off. 


f 4 \t 


The \u underlining command is similar to \_, however it 
will underline only characters, whereas \_ will imderline 
spaces. (See \u embedded command). 


Values: 


none 


£bcamples: 

Produces: 

; . I 

Produces: 


\_Fully undttrlinad including spacas.N^ 



Sons of this is \uundsrlinsd tsxt\u, sons is not. 
Some of this is underlined text , some is not. 


Errors: • Make sure to turn off underlining before switching 

between fancy fonts and native printer fonts (see \ff and 
n); extraneous lines may result. 


• When using native printer fonts (see \fn) if underlining 
remains on between printed lines, the left margin will be 
underlined. 

« 

Notes: • \_ will underline spaces and relative horizontal motion 

forward (\i+..). Any white space created by tabs or the 
\h command will not be underlined. 


• Notice that \_ can be turned of by another \_ or by \u. 
Therefore, \_ and \u cannot be used at the same time. 


• Notice that \_ is the ‘underscore’ key. 

Suggestions: • Use continuous underlining in conjimction with the \i 

command to create horizontal lines of any desired length. 
Since \i is limited in the amount of space it can leave, 
use multiple \i conunands to create as long a horizontal 
line as is desired. 
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Don’t forget to 
or \u). If you 
underlined. 


Printing with Fonts 

turn off underlining (by using another ^ 
forget, the remainder of your text will b} 
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S •>— Left Indent 


Left Indent — \> 


■WliP 


ndont the specified number of units from the left margin; effectively setting 
, new left margin for all subsequent printing. 



or - option><Horlzontal Mea^e> 


Jsage; 


1^' 


V 


^ ■ A* 


lvalues: 






Sxamples: 




Produces: 


errors: 


btes: 


4'r 


uggestions: 


\> causes all normally printed lines to be indented by 
the specified amount. Notice that the direction of the 
‘arrow’ points in the initial direction in which the 
indentation occurs. 

<Horizontal Measure> 

A number preceded by ‘+’ will add the indicated amount 
to the indentation, ‘ will subtract and no ‘+’ or ’ 
causes the indentation to be set exactly the specified 
amount from the left margin. The evaluated Horizontal 
Measure (that is, the final position on the line) must be 
between 0 inches and the current line width minus the 
current right indent, (i.e. LW minus \<). See LW 
parameter and \< embedded command. 

\>liNotice the indentation for this line and all subsequent 
lines until the left indentation\>Oiis again changed. 

Notice the indentation for this line arid all 
subsequent lines until the left indentation 
is again changed. 

Indent past the line width (LW parameter) is not 
allowed; an error message will be displayed and the 
command ignored. 

A tab (\t or Control—I) processed with the print head 
positioned to the left of the indented area will cause the 
print head to move directly to the indented area, 
regardless of any the absence or presence or tab stops. 
This is useful for outdented lists (for example, 
\>2i\h0i3.\t...\>0i). 


• Indentation causes an implicit break. 

Use \> to alter the left margin within your text. Useful 
for indenting quotes and other special sections of text. 
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\< ■— Right Indent 


Right Indent — 


Indent the specified number of units from the right margin; effectivi 
setting a new right margin for ail subsequent printing. 








jltlki iMTl i I Aii > I. 

\,<<+ 

LM * UJJAM»A Wgg i T JJ 


or 


o 




Usage: 


Values: 


Examples: 


Produces. 


\< causes all normally printed lines to be indented 
the specified amount. Notice that the direction of t| 
‘arrow’ points in the initial direction in which tj 
indentation occurs. 

<Horizontal Mea8ure> 

A number preceded by ‘4-’ will add the indicated am 
to the indentation, ’ will subtract and no or ‘ 
causes the indentation to be set exactly the specified 
amount from the right margin. The evaluated Horizontal 
Measure (that is, the final position on the line) must 
between 0 inches and the current line width minus the* 
current left indent, i.e. LW minus \>. In other words, 
the Horizontal measure must specify a position to the 
right of the left indent location. 








*=, ■ 




\<3iNotice tha indentation for this line and all snbeeqaant 
lines until the right indentation \<Oiis again changed. Sat 
the long line after the change of indentation! 


V; . 


Notice the indentation for 
this line and all subsequent 
lines until the right 
indentation 

is again changed. See the long line after the change of 
indentation! 


Errors: Right indentation past the current left indentation (\» 

or left margin (LM parameter) is not allowed. A 
warning message will be displayed and the command 
ignored. 

Notes: • An indentation command causes an implicit break. 

• With some effort, \< and \> commands can be combined 
with the backwards vertical motion (when provided by 
printer) to print multiple columns. 
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Use \< to alter the right margin within your text. 
Useful for indenting quotes and other special text. 




% 





o 
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\t — Comment 

Insert a notation (comment) in your text. 


Comment — 



Usage: 


Values: 




characters> <new 




Place \I anywhere in your text. All subsequent 
characters on the input line will be totally ignored (that 
is, not printed). The new line at the end of the input 
line stops the commenting feature. 

<any charactersXnew line> 

Any and all characters may follow the \! command. All 
characters up to, but not including the new line, will be 
ignored. 



Examples: 

Produces: 

Errors: 

Notes: 

Suggestions: 


HiIb is printed.\!This is neither printed nor \f4proce88ed. 
This is printed. 

none 



The new line at the end of the comment is treated as a ^ 
new line character if word wrap is off (\x), it is treated / 
as a space character if word wrap is on (\w). I 


Use the comment command to include notes to yourself 


or others, in your text file. For example, it may be 
useful to put a comment at the beginning of a text file 
to indicate the date of creation, the intended fonts, the 
name of the person creating the file, etc. 
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p.8 1 parameter specification 


program is designed to be adaptable to many different 
ppllcations. This adaptability is controlled by a number of ‘parameters’, 
IchTps^simeter may be used to control some aspect of printing such as 
]|Jj||C^idth, page length, fonts, etc. In general, parameters are designed to 
jjftve 3normal initial settings so you don’t need to specify each parameter 
Oftch time you use Pfont. 

You will need to provide the name of the file you want to print and 
probably will also want to indicate the fonts to be used. We call these 
♦parameters’ to Pfont. 

different users have different needs at different times and many users have 
different approaches to using computers. Therefore, we have designed Pfont 
to provide 3 methods of interaction. You may select to use any one or a 
combination of these methods each time you use Pfont. The methods are: 
J) Interactive— parameters are specified one or more at a time, help may 
be requested at any time; 2) Command Line— all parameters are specified 
bn the DOS (or CP/M) command line; and 3) Parameter Input 
Input is obtained from a prepared file containing parameter specifications (it 
Is^lntended that this file be reused for multiple ’’runs” of Pfont). 

New users should be most interested in the interactive method, frequent 
and experienced users should learn how to use the parameter input files 
and command line methods. 




less of the method of interaction, you can specify any number of 
parameters using upper or lower case or any combination thereof. If you 
ip^ify the same parameter multiple times, only the last specification of the 
parameter will be used. If the parameter specifies a list (such as +FO 
Romnl2 Romnbl2 ...), each time the parameter is respecified the old list is 
discarded. Thus, if you try to specify +LW (line width) twice, only the 
iccond specification will be used. Likewise, using +FO (fonts) a second 
time will completely negate the first +FO. 

' ' ■ -V ^ 

When learning or uncertain about the use of Pfont, it is best to 
experiment. Make frequent use of the help facilities (?, &:) and feel secure 
In that Pfont performs no destructive operations. 


Interactive Mode 

Pfont is designed to assist in its use; this is particularly true in the 
Interactive mode. To use Pfont interactively, start by typing the following: 



o c 
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\l — Comment Comment — \| 

Insert a notation (commit) in your text. * 



Usage: Place \! anywhere in your text. All subsequent 

characters on the input line will be totally ignored (that 
is, not printed). The new line at the end of the input 
line stops the commenting feature. - 

Values: <any charactersXnew line> 

Any and all characters may follow the \! command. All 
characters up to, but not including the new line, will be 
ignored. 

Examples: This is prlntedAIThls is neither printed nor \f4proces8ed. 

Produces: This is printed. 

Errors: none 

Notes: The new line at the end of the comment is treated as a 

. new line character if word wrap is off (\x), it is treated 

as a space character if word wrap is on (\w). 

Suggestions: Use the comment command to include notes to yourself 

or others, in your text file. Fbr example, it may be 
useful to put a comment at the beginning of a text file 
to indicate the date of creation, the intended fonts, the 
name of the person creating the file, etc. 
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V-'.- . 

p,2 PARAMETER SPECIFICATION 

Xhe Pfont program is designed to be adaptable to many different 
^plications. This adaptability is controlled by a number of ‘parameters’. 
Each parameter may be used to control some aspect of printing such as 
line width, page length, fonts, etc. In general, parameter are designed to 
have normal initial settings so you don’t need to specify each parameter 
each time you use Pfont. 

You will need to provide the name of the file you want to print and 
probably will also want to indicate the fonts to be used. We call these 
♦parameters’ to Pfont. 


Different users have different needs at different times and many users have 
different approaches to using computers. Therefore, we have designed Pfont 
to provide 3 methods of interaction. You may select to use any one or a 
combination of these methods each time you use Pfont. The methods are: 
1) IntCTactive— parameters are specified one or more at a time, help may 
bo requested at any time; 2) Command Line— all parameters are specified 
on the DOS (or CP/M) command line; and 3) Parameter Input File- 
Input is obtained from a prepared file containing parameter specificatioiiirr(it 
is intended that this file be reused for multiple ’’runs” of Pfont). 


- 




New users should be most interested in the interactive method, frequent 
and experienced users should learn how to use the parameter input files 
and conmiand line methods. 


Regardless of the method of interaction, you can specify any number of 
parameters using upper or lower case or any combination thereof.* If you 
specify the same parameter multiple times, only the last specification of the 
parameter will be used. If the parameter specifies a list (such as +FO 
Ronml2 Romnbl2 ...), each time the parameter is. respecified the old list is 
discarded. Thus, if you try to specify +LW (line width) twice, only the 
second specification will be used. Likewise, using +FO (fonts) a second 
time will completely negate the first +FO. 

.•V •» 

When learning or uncertain about the use of Pfont, it is best to 
experiment. Make frequent use of the help facilities (?, <k) and feel secure 
in that Pfont performs no destructive operations. 



Interactive Mode 

Pfont is designed to assist in its use; this is particularly true in the 
interactive mode. To use Pfont interactively, start by typing the following: 
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B> Pfont/ 

Pfont will respond with its usual greeting message as well as reminding you 
to indicate parameters such as font names and a file name and that ‘?’ 
may be typed at any time for assistance. Pfont prompts with ”>>’’ and 
awaits input. You may enter as many or as few parameters as you like and 
may also make use of the special characters (or ‘<’) and 

‘Control—V’ (see section P.2.5). | 

c ‘ * 

■ i-- 

In the .following transcript of Pfont use, user input is underlined, ^ is 
‘return’ and commentary is m small italics. I 


Pf ont,^ Start Pfont, 

Pfont: Print with Fonts, ... Pfont identification and version. This message 

Copyright <C) 1984 SoftCraft, Inc. overwrites a temporary ^loading” message. 
Enter printing parameters, for example: 

*(*F0 Romni2 RomnB12 +FI File.ff 

Then press RETURN (possibly more than once) to start printing. 

Type ‘7’ for assistance at any time. 

» 7 Request for assistance. 

Expecting a Parameter Specification - a *+* or *-* followed by 
One of: Pfont is expecting any of the following 

FI (Filenames) FO (Fonts) 


t 


» ^■rd7 

Expecting value for RD (Rough Draft) 
Current Value: <0ff> 

» RD (Rough Draft)> ^ 

» -^fi Sample.FF^ 

FI (Filenames)> ^ 

» ■♦•fo Ronnl2 Ronnbi2 Romnil2,^ 

FO (Fonts)> ^ 

» k 
• • • 

» 

Loading Ronnl2.Fon as font number 0 
Loading Romnbl2.Fon as font number 1 
Loading Romni12.Fon as font number 2 

Make sure the printer is *0n Line* 
Printing Sample.FF 
Page 1, 42 Lines 
B> 


Pfont lists many other options 
Pfont will indicate ”— more —" after the 
number of lines that fit on your screen are 
displayed^ press any key to continue. 
Select the Wd^ parameter, then ask for help. 
- a Integer Between 0 and 6 

Pfont indicates the current setting for 
Rough Draft (Off) and possible settings. 
User selects rough draft mode L 
User indicates that file Sample. FF 
is to be printed (-f-FI is optional here). 
^ indicates no more file names. 

User selects S fonts. 
^ indicates no more fonts. 
Request summary of current settings. 
Pfont lists the settings of all parameters. 
A final ^ ends interaction and starts printing. 
... in memory 
... in memory 
... in memory 

The S fonts are now ready for use. 
Reminder to get the printer ready. 
Pfont will now start printing. 
Pfont has finished printing the first page. 

All done. 


Part P — Printing with Fonts 


Notice that return is used to ^nd a parameter specification and also to 
end interaction and begin prompting. The ending function of a only applies 
when it is the only input on a line. When you type ^ at the end of a 
e^uence of characters, it allows you to continue specifying the same 
ptoameter. If this seems confusing or if you ever feel stuck while using 
Pfont, simply type a couple of ,^’s and Pfont will either start printing or 
display a message indicating additional parameters that must be specified. 

Command Line Mode 




Pfont can be used without any interaction by specifying all of its 
parameters on the DOS (or CP/M) command line. For example, 

jr B> Pfont ^■fi Sample.FF -ffo Ronnl2 RomnB12 RomnI12 


will print the contents of the file Sample.FF using 3 Roman fonts. The 
maximum length of the parameter specification list is 128 characters. For 
longer parameter specification lists, user interactive mode or a parameter 
input file. File and font names can by typed in any combination of upper 
and lower case. CP/M users note: CP/M converts all command line input 
to upper case, so parameters that have case sensitive values should be 
entered either interactively or using a parameter input file. Pfont modifies 
the CP/M convention somewhat; it converts the first character of each 
string to upper case and converts all others to lower case. For example: 


input: Pfont test +lil "CHAPTER TWO" +fl "end of page" 

result: Pfont Test +H1 "Chapter two" +F1 "End of page" 


To avoid this capitalization, use the parameter file input method described 
in section P.2.3. . 


Any of the special characters etc. can be used on the 

command line, and 2 u*e of particular use (see section P.2.6). 

>'-v - - 

If you make an error during command line interaction you do not have to 
retype the line. Pfont retains the portion of the command line following 
the error, begins interactive mode, and displays an error message and 
several options of correcting the error and continuing. Often you need only 
retype the word causing the error; Pfont will continue with the rest of your 
command after the error has been repaired. See section P.5 for details. 
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p.2.3 Parameter File Input 


As you become an experienced Pfont user, you will find that you often i 

wish to print a letter or document multiple times or to print similar letters < 

or documents using the same settings for Pfont parameters. Pfbnt’s j 

parameter file input capability makes this possible. A parameter file is 1 

simply a file containing parameter specifications exactly as you would type 
them on the command line or interactively. To request parameter 
specifications that have been stored in a parameter file, you need only type; ] 


©file name r 1 

- 1 

Where file name is the name of the parameter input file (names with the j 
extension ‘.ffi’ are used by convention, e.g. Sample.ffi). The ©file name can 
be included anywhere on the command line or be used at any time in the 
interactive mode. (CP/M users may type ‘<’ in place of if desired). 

To create your own parameter files, use your editor to create a file 
containing parameter specifications; the parameter file may contain one or 
more lines. One or more parameter input files can be used for any ”run” 
of Pfont. Parameter input files can contain additional requests for 
parameter input (i.e. ©file name). However, any parameters specified in 
the original parameter input file after the ‘®’ will be ignored. For most 
uses, if a parameter input request is used within a parameter input file, the 
request should be the last item in the file. Note that parameter input files 
should never contain blank lines. Such a line is treated as a command to 
start printing (‘Return’) and thus will prevent subsequent lines from being 
processed. 


It is recommended that you create a separate parameter input file for each 
type of printing you normally do (e.g. letters, mailing labels, disk labels, 
etc.). A parameter input file for labels might contain the following: 

-t-FO RoBnl2 OldalS 

+LW 2.Bi +PL 11 +TM ,1251 +BM .1261 
-LM 


P ,2.4 Which Disk Drives To Use/Switching Diskettes 

Pfont requires that each of the files Pfont.exe, FancFont.pro, Pfont.hlp, 
?^font.hle (CP/M Pfont.com, PfontOO.ovl, PfontOl.ovl, Pfont02.ovl, 
^fontOS.ovl, Pfont.hlp, Pfont.hie and FancFont.pro) be resident on one of 
he system disk drives. It is simplest to put all of these files on one disk 
nd use Pfont while "logged” to the drive in which that disk is mounted, 
sowever, Pfont will find its overlays (PfontOO, PfontOl, Pfont02, PfontOS, 
ancFont.pro) if they are either on. the logged disk or are on a disk 
ounted in disk drive ‘A’. Pfont.hie and Pfont.hlp are not absolutely 
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(lecessary — they are ‘help’ files and may be deleted if necessary. If not 
available on the working disk, then no help will be available when 
recovering from Pfont interaction errors and the Control—V general help 
comniand will provide no help. Otherwise, the contents of the 
lystem diskettes may be arranged in any way you desire, including copying 
to a ‘hard’ disk. 

.■’''V.-Wi-- f .. 

For DOS systems with limited disk capacity (one diskette drive), the Pfont 
program may be invoked (for example, by typing Pfont^x ) and then the 
Pfont disk removed and a disk containing all fonts and files to be printed 
Inserted in the diskette drive. Type the appropriate parameters and begin 
printing as usual. 

For CP/M systems with a small disk storage capacity, such as the Osborne 
[, it may be necessary to switch diskettes in order to print long documents 
ivith multiple fonts. The following procedure is recommended: 

1. Put all fonts to be used on one diskette (the font diskette). 

2. Place the font diskette in drive B. 

3. Place the file or files containing text on one diskette (the text 
diskette). 

4. Insert the Pfont diskette in drive A. 

6. Invoke Pfont using interactive mode. 

6. Remove Pfont diskette and insert text diskette in drive A. 

7. Interactively (or with parameter input file) specify Pfont printing 
parameters. 

8. Remove text diskette and insert Pfont diskette in drive A. 

9. Type final ^ (carriage return) to start printing. 

10. Pfont will prompt for disk change; following prompt, remove Pfont 
diskette and insert text diskette in drive A. 

11. Printing should start, no further disk changes are required. 

?-»2.5 Special Characters 

Phese special characters are recognized and acted upon by Pfont in any 
nteraction mode, they are primarily used in the interactive mode, however. 

P Always provides assistance. ‘?’ may be used at any time during 

command line or interactive modes of Pfont use. The response to 
a ‘?’ assistance request is information pertinent to the current 
usage of Pfont. In interactive mode, pressing ‘?’ will produce a 
list of all available parameters if issued following the ‘>>’ 
prompt. If pressed following a parameter name (e.g. +Rd ?), a 
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description of acceptable parameter values as well as the current 
value for the parameter will be displayed. For example: 

i 

» -t-Rd ? • h 

Expecting value for ,RD (Rough Draft> - ... V 

Current Value: <0ff> ft 

RD (Rough Draft>> 

4 

'T'-i 

» -t-Fo RoaniS RoanIi27 r 

Expecting FO (Fonts) list elenent - a Font File Name 
Current Value: 

0: Ronnl2.Fon 
1: RonnI12.Fon 
FO (Font8)> 

may appear anywhere on the command line following Pfont, 

It will cause the interactive mode to be entered and Pfont will 
provide assistance. The most common command line use, 
however, is: 
i Pfont 7^ 

This provides general assistance on using Pfont and displays a list 
of all parameters and their default settings. 

Display the current settings for all parameters. This is a good 
way to review any parameters you have specified and to 
determine the initial settings for all other parameters, ic may be 
issued interactively or on the command line. For example: 

» * 

FI (Filenamos) - List of up to 15 File Names 
Current Value: 

0:Sample.ff 

FO (Fonts) * List of up to 10 Font File Names 
• » • 

Explicitly begins the interactive mode. Use this at the end of the 
command line if you have additional features you wish to specify 
interactively. For example: 

■ B> Pfont CTest.ffi 

Pfont: Print with Fonts, version x.x (Epson FX) 

Copyright (C) 1984 SoftCraft, Inc. 

» 


Obtain parameter specifications from the parameter input file. 
Continue processing any remaining command or interactive input 
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line parameters after input from the parameter input file. 
may be used multiple times on the command line and/or 
interactively. See section P.2.3 for more information. CP/M and 
DOS 1.1 users may substitute for all users may use 
or everywhere other than on the command line. For example: 

B> Pfont CControl.ffi 

will read the file Control.fli as though its contents were typed on 
the command line and then Pfont will enter interactive mode 
(because of the comma) to allow further specification of 
parameters or override parameters specified in Control.ffi. 


^Retum^ (>) Ends input — it can be used to exit the interactive 

parameter specification, to end a list or to end a parameter if you 
decide it is not the one you wanted (useful after using ?, for 
example; ‘+rd V followed by / leaves ‘rd’ as it was). ‘Return^ is 
ignored if it is not the first key typed on an input line and thus 
can be used to help in typing long lines. 

?. .,s 


^Control—V’ Display on the terminal a description of the special 

characters (this can only be used interactively). The file 
‘Pfont.hlp’ must be on the logged disk. 


Control—Z’ Exit Pfont, ignore all parameter settings and do not 

print. Pfont will ask for a confirmation of a Control—Z request. 
Control—Z may be pressed whenever you are using Pfont in the 
interactive mode. (CP/M users must use ‘Control—C’ in place of 
‘Control-Z’.) 

Back Space^ (normally Control—H) Backs up one character at a time to 

correct typographical errors. The back space character and its 
displayed action can be set in the profile file (FancFont.Pro — 
see appendix A6). 


Control—U’ ^ Delete an entire input line. This line delete character is 

analogous to the DOS (or CP/M) line delete function and is 
operational in interactive mode. 
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A 


.3 PARAMETERS 




^font offers a variety of parameters (features) to control the appearance, 
Drmatting and printing of a document. Most of the parameters have 


,‘jsr. 




reset (default) values and hence need not be specified during each use of 
ffont. However, you will want to use these parameters at different times 
0 fully exploit the capabilities of the system. Each parameter 

ontrols some aspect of the formatting and printing of text. A parameter 
flay be turned off or on or left at its normal (default) setting. 






'his section describes each of the parameters in detail, discussing the 
ommon aspects of using the parameters and then the method by which 
he parameters are described in the manual. Each parameter specification 
ts the format: 

<On/Off switch> <Parameter Name> <Parameter Value> 

'he On/Off switch is used to indicate whether the parameter is to be used 
r not. indicates On and indicates Off. The name indicates which 

arameter is being specified and the values detail the use of the parameter 
some parameters do not require values). Many parameter values require a 
ait (i.e. inches, dots, centimeters) indicated by a single character (i,d,u) 
imediately at the end of the value. For example, 

+TM 1.6i 


i': 


>ecifies that the top margin parameter be used and that the top margin 
? 1.5 inches. 


-TM 


ecifies no top margin (this is exactly the same as +TM Oi). Some 

irameters have no values, they are either on or off. For example; 


T 

of 

ii 

#1 

se 


pi 

h 


S 

P 


+PP 

ecifies that single pieces of paper are being used (the page pause 
rameter is on), and 

-PP 

licates continuous form paper is in use (do not use the page pause 
ameter). Finally, some parameters can have a value that is a list of 
ns: 

+F0 SanSiO SaziS12 Roiiinl2 

as on the parameter (+FO) and indicates that each of the 3 

s listed is to be used. As before, 

-FO 

f'ates that no S*am^3(ynjts are to be used (the parameter is off). 


imeter names may be specified in either upper or lower case or some 
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jmblnation of both. There must always be ^ least one space between the 


of the parameter name and the parameter value. 



M Parameter Description Format 


he rest of section P.3 describes each of the parameters, each parameter on 
'new page. The top line on the page indicates the descriptive name of the 
Burameter. The second line gives a very general description of the meaning 
f the parameter. Then the syntax of the parameter is presented. The 
rntax indicates how to type the parameter, either turning it on or off, 
hether it requires any values and what those values au'e. At the right edge 
^the syntax line, the default (normal) use of the parameter is indicated. If 
)u do not specify the parameter, the default for that parameter will be 
jed. 


he usage indicates how to use the parameter; first how to turn the 
wameter on, then how to turn the parameter off and the meaning of each 
these. The values section provides details about the parameter’s values, 
jscribing acceptable and unacceptable values and the meaning of each, 
he final 3 sections provide examples^ notes and suggestions. Each of these 
ctions will help clarify the use and meaning of the parameter. Notes 
‘ovide the most detailed information and suggestions provide ideas as to 
)w to best use the parameter. 

action P.1.1 describes some particular terminology used in describing Pfont 
inting parameters. 
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P,3.1 The Parameters | 

• } " '' 

The parameter descriptions follow in alphabetical order on the ensuing g 

pages. The parameters, grouped according to function, are: i Jj 

’ I 

Font Selection Page Setup Horizontal Format 

p 1 
I 

FO font • selection HL header line TB tab stops 

RD draft mode FL footer line LW line width t ' 

SD screen display PN page number LM left margin ^ 


Print Control Vertical Format Miscellaneous 


NF first page special 
PP page pause 
PF process form feeds 
FP select first page 
LP select last page 
NC number copies 


HM header margin 
FM footer margin 
TM top margin 
BM bottom margin 
PL page length 
PG pagination enable 
RV peverse paper feed 
SP interline spacing 


SU string substitution 
FI file names 
CF concatenate files 
IS initialization string 
UU user defined units 
Cl command indicator 
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— Bottom Margin Bottom Margin — BM 


Specify the amount of white space to appear after the bottom of the main 
>pdy of text on a page. 





i ?. ii ; '>r fa 'f I. in rn n i i i > r r i m 111 'l 1 1 n H i i 1 1 1 ' 


Jsage: • +BM <Vertical Measure> 

% The amount of white space to plzice at the bottom of 

each page. This is the distance from the actual bottom 
^ of the page to the bottom of the last line of text on the 

page (other than the footer line). 

. -BM 

Do not leave any white space at the bottom of each 
page, no bottom margin (same as +BM Oi). 


i^alues: <Vertical Measure between 0 and 426 inches> 

A number between 0 and 426 inches. This is the 
amount of white space to be left at the bottom of each 
- page. 

Examples: . +bm .tbi 

Leave a ,75 inch bottom margin on each page, 

. -BM 

No bottom margin. 


Sfotes: • The bottom margin is actually measured in printer 

specific vertical units (l/72”‘* inches for Epson MX, RX 
and FX printers). The value is converted to .vertical 
units; any fractional units are ignored. 

• If there is no bottom margin (—BM), then there can be 
no Footer Line (FL). 


• If FL is specified, the bottom margin must be large 
enough to accommodate the height of the footer line plus 
the footer margin (FM). 

Mlggestions: If you change the Page Length (PL) you will probably 

want to also change the top and bottom margins (TM 
and BM). 
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/F — Cioncatenate Files 


Concatenate Files — Cl 


odicate whether files are to be individually printed or concatenated during 
irinting. 


+CF or -CF 

:y-g?>:-.vw-:i: yi i ■ i ■ 1 11 ■ 1 111 1 1111 m i n i mnn 11 j r n ' Tt. tT .rr r T.ir iT i irrgtT 




Jsage: 


\iefauU: +CF I 

.IffjjJ!l>T »T .TI7jni T ILW.I. < TI. T ^^^ I n I, I 


+CF 

The text from all files specified with the Filenames (FI) 
parameter is to be printed as if it came from one file. 
No page breaks are automatically included between files, 
However, each file must end with a carriage return or 
one will be provided (if not using word wrap). If using 
word wrap, lines will be appended to each other as words 
fit, even between concatenated files. 

-CF 


The text from all files specified with the Filenames (FI) 
parameter is not to be concatenated. A page break is 
automatically inserted before printing the contents of the 
next file and all embedded printing controls are reset 
(e.g. font, underlining, word wrap, indentation). Page 
numbering will restart at 1 or the value specified with 
the Initial Page Number (PN) parameter for each file. 


'^alues: none 


xamples: • +cr 

Concatenate the contents of all files in the Filenames (FI) list 
without page breaks, 

• -CF 

Force a page break between printing the contents of each file in 
the Filenames (FI) list 

otes: • See Initialization String (IS) parameter for related 

information. 

• See Control—F — next file interactive command, section 

P.4. 

ggestions: Use +CF for printing a document that has several 

sections where each section is contained in a different file. 
Use — CF for printing several unrelated documents in the 
same ”run” of Pfont. 
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-— Command Indicator Command Indicator — Cl 


jcify a character to identify commands embedded in text files. 



age: • +CI <1 character> 


A single character to be used as a flag to indicate 
embedded commands within the text files. Normally this 
character is 
. -Cl 

Use the default command indicator (‘\’). Same as +CI 

\. 

ilues: <1 character> 

The command indicator must be 1 character and should 
not be a character used for an embedded command. The 
upper and lower case characters and special symbols I, 
<, >, are specifically not recommended. It is best 
to select an infrequently used character such as , V’ 
or ‘%\ 

amples: . +ci x 

Change the command indicator from to ^%\ 

. -Cl 

Use the default command indicator. 

tes: • Command indicators are case sensitive; that is, they only 

work in the case (upper or lower) that you specify. 
Warning, CP/M users: if the conunand indicator 
parameter is specified on the CP/M command line, the 
Cl will automatically be converted to upper case. 

• If you need to print the conunand indicator, type it twice 

in the text file (e.g. ‘\\’ will print ‘\’). 

ggestions: • Change the command indicator if the default command 

indicator is frequently used in a document or is 
difficult to generate with your keyboard. Be careful to 
change the command indicator each time .you reprint a 
file containing other than the default command indicator 
•(using an FFI file, section P.2.3, wifi make this easy). 

• Apple users — specify ‘4-CI /’ (for example) to allow the 
command indicator to be a character easily producible 
from your keyboard. 
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FI — Filenames 


Filenames — |] 


Specify the files containing the text to be printed by Pfont. 



Usage: 


Values: 


ibcamples: 


otes: 






file names> IdefauU: none 




+FI <list of 1 to 15 DOS (or CP/M) file naines> 

Print the contents of the listed files. When more than 1 
file is specified the files can either be concatenated or 
printed with intervening form feeds (\p) as specified by| 
the Concatenate Files (CF) parameter. The default is to^ 
concatenate files. Note that —FI is meaningless. | 

<list of 1 to 15 DOS (or CP/M) file names> | 

Each file named must be a valid DOS (or CP/M) file.! 
File names containing special Pfont characters (‘+’, 

...) must be enclosed in double quotes (””)• Two' 
special names may be used in the file list. A file name of 
‘tty:’ (or ‘con’ for DOS only) indicates that input is to 
be obtained from the user’s terminal as if it were input 
from a file. With this parameter, Pfont allows your 
computer to be used as an electronic typewriter. 
(‘Control—Z’,^ indicates the end of terminal input), ‘tty:’ 
may appear anywhere in the file name list and may 
appear more than once. The file name ‘loop:’ indicates 
that the list of file names is to be used repeatedly until 
the user explicitly causes printing to stop, ‘loop:’ should 
appear as the last name in the list and should not be 
the only name in the list. 

• +fi Banual.txt B:appandix 

Print the contents, of files ^manuaitxt^ and ^appendix” 
(*^appendix^ from disk *B*), 

• +FI enyelope.ff tty: letter.ff loop: 

Print contents of "envelope,ff*^f then enter text to be printed 
using the keyboard, then print contents of ^letter,ff*^. Continue 
this sequence indefinitely until user enters Control—Z (CP/M - 
user Control—C) to force it to stop, 

• At most 15 items may appear in the list of file names. 

• A sequence of file names may be entered without the 
‘+FI’ control for convenience, but the file names may not 
immediately follow any other list. This allows a 
command line such as: 

Pfont Benual.txt appendix 
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# 

FI is special in this way, it is the default parameter. 

The files are checked to determine that they can be 
opened for use by the Pfont program. 

See the Concatenate Files (CF) parameter for controlling 
the printing of multiple files. 

Use ‘tty:’ (or ‘con’) for using your computer as an 
electronic typewriter or for filling variable sections of 
letters and forms. Use ‘loop:’ for printing multiple copies 
of. the same file or sequence of files. When using loop:, 
it is usually desirable to specify —CF so that each copy 
begins on a new page. See also +NC for making 
multiple copies. 
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— Footer Line 


Footer Line — fj, 


[Control printing of a footer line in the bottom margin of every page or 
©parately for odd and even pages. • 


miKmm <ijst of 1 or 2 8tring8> or -t'L 




Jsage: 


+FL <string> +FL <string> <string> 

Specify 1 line to appear at the bottom of every page at 
a distance from the bottom of the page indicated by 
Footer Margin (FM). If 2 strings are specified, the first 
is to appear on odd numbered pages only, the second on 
even numbered pages only. If only one string, then this 
will appear on all pages. 

-FL 

No footer line will appear in the bottom margin. 


/allies: <list of l or 2 strings> 

The string is a line to appear in the bottom margin of 
every page. The string can contain any embedded 
commands to control fonts, underlining etc. The length 
of the string must not exceed the Line Width (LW). It 
the string contains any spaces or special Pfont characters 
‘?’, etc.), surround the string with quotes If 

one string is used, this will be the footer line for all 
pages. If two strings, the first will be used for all odd 
numbered pages, the second for all even numbered pages. 


Examples; . -fFL *A D&j at the Lake — Section 3" 

The string A Day gi th^ Lake — Section S will appear in the 
bottom margin of every page. It will start at the left margin. 

• +FL »\f2The Bik®r\fl\rpag® \s#" 

The bottom margin of each page will contain a line with The 
Biker left justified and in font 2, and the word moe followed by 
the page number right justified and in font 1. 

• +FL "Paga \8#\rChaptar 2" "Chapter 2\rPage \8 #"b 

The chapter and page number information will be printed at the 
bottom of every page, however it will be printed in reverse order 
. on odd and even pages. This would be used to ensure the page 
number appears on the outside edge of each page in a bound 
document printed on both sides of the paper. 

otes: • The footer line will always be printed using font 0, no 

underlining etc. unless otherwise specified. 


• Each footer must be restricted to a single print line. 
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See the Not On Firsf Page (NF) parameter to disable the 
printing of the footer line on the first page of a 
document. 

See FM and BM for determining the exact location of 
the footer line on a page. 

The current font, underlining, etc. for normal text 
printing will not be affected by any embedded commands 
in the footer line. 

To print a footer line on even or odd pages only, you 
must use a ‘filler’ for the other type of page. For 
example: 

+FL "Even footer" 

will print ‘Even footer’ on even pages with no footer 
printed on odd pages. Likewise, 

+FL "Odd footer" «»• 

will print ‘Odd footer’ on odd pages. 

CP/M users: CP/M converts all characters on the 
command line to upper case. Pfont will adjust so that 
the first word of a string is capitalized. For best results, 
avoid this problem by using interactive mode or. a 
parameter input file to input the footer line. 

Most embedded commands can be used within footer lines 
to control the formatting of these lines. For example, \f, 
\r, \c, \<, \> will work properly. Vertical formatting 
commands (e.g. \v, \p) will be ignored when used within 
footer lines. 

Word wrap (\w) could be used inside of footer lines. In 
this case, the footer line will be filled with the proper 
number of words to fit within the current margins and 
indentation. This means that extra words to place in the 
footer may be taken from the text file. This is not 
recommended as the results are very difficult to predict. 

Use FL with the \s# embedded command to print the 
page number at the bottom of each page. Use FL with 
the \c and \r embedded commands to produce a left, 
centered and right justified footer line. 
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FM — Footer Margin Footer Margin — f) 

Specify the amount of white space between the bottom of the footer Hj 


md the bottom of a page. 


.. 



Usage: 


V'alues: 


Examples: 


^otes: 


iiggestions: 


• H-FM <Vertical Measure> 

Leave the specified white space between the bottom o(| 
the footer line and the bottom of the page. 

. ~FM 

Place the footer line at bottom of page, no white spaced 
following the footer line. 

<Vertical Measure between 0 and 425 inches> 

A number between 0 and 425 inches. This is the 
amount of white space between the bottom of the footer 
line and the bottom of the page. 

• +FM .5i 

Leave .5 inches of white space between the bottom of the footer 
line and bottom of page, 

• -FM 

No footer margin. 

The footer margin is actually measured in vertical printer 
dots (1/72"** inches for Epson printers). The number of 
inches is converted to dots; any fractional dots are 
ignored. The footer margin plus the height of the footer 
line must be less than the bottom margin. If no footer 
line (FL) is specified, the footer margin is not used. 

Consider changing the header margin and footer margin 
(HM and FM) when changing PL, TM or BM. 







Part P — — Printing with Fonts 


Fonts 

^te the fonts to be used for printing. 


Fonts —— FO 
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+FO <list of 1 to 15 font file names> 

Print using 3*am^ 3><ynJs. The names and order specified in 
the file name list specifies the fonts to be used. See the 
\f embedded command. CP/M users: a maximum of 10 
font file names is allowed. 

-FO 

Do not use 3fyrJ&. Use native printer fonts (see \f 

command). If +FO is not provided with one or more 
font names, then only native printer fonts can be used in 
the document. 


lu6S: <list of 1 to 15 file names> 

Each name should be that of a font file containing the 
definitions of characters. The conventional ‘.fon’ 
extension need not be given; if it is left off, Pfbnt will- 
append it. The first font in the list will be known as 
font 0, the second as font 1, etc. CP/M users: a 
maximum of 10 font file names is allowed. 


SLUiploS* • -t-FO Roffinl2 Romnbl2 SanslO 

Use font file ‘RomnlSJon* for font 0, ^Romnbl2,fon^ for font 1 
and ^Sansl0,fon^ for font 2. 

• +F0 biSansS.fon SanslO.fon 

Use font file ^SansSJon^ (from disk B) for font 0 and 
^SanslOJon’ for font 1. 

tes: • The files are tested before printing begins to see if they 

are valid font files. 

• The order of the files is important. It specifies the 

mapping to the embedded \f commands, but also controls 

printing speed by partially determining which fonts fit in 

memory. For fastest printing, put your most frequently 

used fonts first in the list. If you have an electronic disk 

emulator, printing speed will be improved by moving ‘on 

disk’ fonts onto the electronic disk. 

••• 

• Before printing, Pfont will indicate which fonts fit in 
memory and which will be used directly from the disk. 
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In some CP/M systems there may not be enough memory^ 
to accommodate 10 fonts. In this case, an error message^ 
will be displayed. You will need to reduce the numl^r 
of fonts in your document and/or reduce the length o(; 
header lines (HL), footer lines (FL) and substitutiorf 
strings (SU). 






iiggestions: 


characters etc.). 

When creating a document and determining which fonts 
to use, write down the names and numbers of each font 
and reorder the list so that frequently used fonts appear 
first. 







WM- 
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First Page 

I: • ■ 

IF a portion of the document to be printed. 


First Page — FP 



mr . .A....... . 

+J^P <Page Niimb€r> or ~FP 




default: --WP 



• +FP <Page Number> 

Suppress all printing until the specified page number is to 
be printed. Resume normal printing from the specified 
page to end of document or to 4-LP specification. 

. -FP 

Normal printing, begin printing with the first page of 
document. 


ues: <Page Number between 1 and 9999> 

The page number that is the first page to be printed. 
Any integer between 1 and 9999 may be specified, 
however if the number is greater than the page number 
of the last page, no pages will be printed. 


imples: . +fp 4 

Page number 4 w;i7/ be the first page printed. 

• -FP 

Normal printing, begin printing with first page. 

jBS: • FP works with the same number that would be printed 

on a page; i.e., the one specified with the Initial Page 
Number (PN) parameter. 

• Pages which are not printed are still processed by Pfont 
and thus all embedded commands are checked and 
processed and all warning and error messages are 
displayed. 

;gestioilS: • Use this parameter in conjunction with the Last Page 

(LP) parameter to select one, or a sequence of pages to 
be printed. This is particularly useful if you need to 
reprint a portion of a document, but not the entire 
document. 


• Since error and warning messages will be displayed for all 
pages of a document (whether printed or not), the +FP 
parameter may be used to check a document for errors 
(such as improper commands) without any printing or 
screen display (see Screen Display, SD). This is 
accomplished by using the FP parameter and specifying a 
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large page number (e.g. +FP 9999). To speed fo 
loading, always use +SD in conjunction with t 
technique. 
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Header Line * Header Line 

printing of a header line in the top margin of every page. 


HL 


mi' 
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age: 
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• +HL <string> or +HL <string> <string> 

Specify 1 line to appear at the top of every page a 
distance from the top of the page indicated by Header 
Margin (HM). If two string are specified, the first string 
will appear on all odd numbered pages and the second 
string will appear on all even numbered pages. If only 
one string is specified, it will appear on all pages, 

. ~HL 

No header line will appear in the top margin. 


lues: <list of 1 or 2 strings> 

1 / The string is a line to appear in the top margin of every 

page. The string can contain any embedded commands 
to control fonts, underlining etc. The length of the 

string must not exceed the Line Width (LW). If the 
string contains any spaces or special Pfont characters 
‘?’, etc.), surround the string with double quotes 


dJUplcS! • +HL "Chapter 4 — Going to School" 

The string Chapter — Going io School will appear in the 
top margin of every page. It will start at the left margin, 

• tHL "\f2Canoeing\cThe WildemessVf l\rpage \a#" 

The top margin of each page will contain a line with Canoeing 
left justified and in font 2, the words The Wilderness ceritered 
(also in font 2) and the word page followed by the page number 
right justified and in font 1, 

• +HL "Page \8#\rChapter 2" "Chapter 2\rPage \b#" 

The chapter and page number information will be printed at the 
top of every page^ however it will be printed in reverse order on 
odd and even numbered pages. This would be used to ensure 
the page number appears on the outside edge of each page in a 
bound document, 

tes: • The header line will always be printed using font 0, no 

underlining etc. unless otherwise specified. 


• See the Not On First Page (NF) parzuneter to disable the 
printing of the header line on the first page of a 
document. 










?gestions: 
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• See HM and TM for determining the exact location 
the header line on a page. 


• The current forit, underlining, etc. for normal text] 
printing will not be affected by any embedded commandij 
in the header line. I 


• To print a header line on even or odd numbered pagei’ 
only, you must use a ‘filler’ for the other type of page, 
For example: ] 

+HL "" ’•Even header” 

will print ‘Even header’ on even numbered pages with no 
footer printed on odd numbered pages. Likewise, 

+HL ”0dd header” ”” 

will print ‘Odd header’ on odd numbered pages. 





hSsMm 





/• * 


mm 


Va 


fr.- t-Wi .Vi-•• 


• CP/M users: CP/M converts all characters on the 
command line to upper case. Pfont will adjust so that 
the first word of a string is capitalized. For best results, 
avoid this problem by using interactive mode or a 
parameter input file to input the header line. 


Ex 


• Most embedded commands can be used within header 
lines to control the formatting of these lines. For 
example, \f, \r, \c, \<, \> will work properly. Vertical 
formatting commands (e.g. \v, \p) will be ignored when 
used within header lines. 




Word wrap (\w) could be used inside of header lines. In 
this case, the header line will be filled with the proper 
number of words to fit within the current margins and 
indentation. This means that extra words to place in the 
header may be taken from the text file. This is not 
recommended as the results are very difficult to predict. 


Use HL with the \s# embedded command to print the 
page number at the top of each page. Use HL with the 
\c and \r embedded commands to produce a left, 
centered and right justified header line. 




: 
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( ^— Header Margin 


Header Margin — HM 


the amount of white space to precede the Header Line (HL). 


Pii 


4'HM <Vertical Measure> or —HI 


default: 4-11X1 .26i 


,lues: 


amples: 


• +HM <Vertical Measure> 

The amount of white space between the top of a page 
and the top of the Header Line (HL). 

. ~HM 

Do not leave any white space between the top of the 
page and the top of the header line. 

<Vertical Measure between 0 and 425 inches> 

A number between 0 and 425 inches. This is the 
amount of white space between the top of the page and 
the top of the header line. 

• +HM .6i 

Leave ,5 inches of white space before the top of the header line, 

• -HM 

No header margin. 


ites: The header margin is actually measured in vertical 

printer dots (1/72"'^ inch for Epson MX, RX and FX 
printers). The number of inches is converted to dots; any 
fractional dots are truncated. The header margin plus 
the height of the header line must be less than the top 
margin. If no header line (HL) is specified, the header 
margin is ignored. 

ggestions: Consider changing the header and footer margins (HM 

and FM) when changing PL, TM or BM. 
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— Inltialkation String 


Initialization String — n 


Specify a string to be printed at the beginning of each file. 





<strmR> or — 




f3SSSI3B^ 




Usage: • +IS <string> 

Insert a string of characters, possibly containing 
embedded commands at the beginning of the file to be 
printed. If files are not concatenated (see CF parameter) 
this string will be inserted before each file. 

• -IS 

No special initialization, use default formatting controls 
alues: <string> 

A string of characters, usually embedded commands, to 
specify the starting font, underlining mode and other I 
printing characteristics. If the string contains any blanks! 
or special Pfont characters, surround the entire string 
with quotes 

, 

Examples: . +is »\f3\j» ’ ' 

Begin printing with font S and justified text. 

• -IS 

No initialization. 

lotes: • The initialization string will be applied before printing 

each file that is not concatenated. Thus, it will always 
apply to the first file, and will apply to all others if —CF 
(Concatenate Files) is specified. 

• The built-in initialization is: font 0, no justify, no 
underline (see section P.l for additional information). 

ilggestions: This parameter is convenient for printing files without a 

need to modify them (e.g. listings, data files). 


Values: 


xamples: 


7otes: 
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Left Margin 

the Left Margin of the text to be printed. 



Left Margin — LM 


+LM <Horizontal Measure> or —LM 


+LM 11 

"I jiii y . iT Ti'i' wi j » i i ii ' iii 




tlues: 


-*it- 
.''r' 
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camples: 


+LM <Horizontal Measure> 

Specify a left margin for all text to be printed. 

-LM 

Turn off the left margin parameter; there will be no left 
margin. (Same as +LM 0). 

<Horizontal Measure between 0 and 8 inches> 

The number of inches to be used as a left margin for all 
text to be printed. The left margin must be between 0 
and 8 inches (13.6 inches for wider printers). A left 
margin of 0 inches indicates no left margin and is 
equivalent to —LM. 

+LM 1.5i 

Set a left margin of 1»5 inches, 

-LM 

No left margin — text will be printed flush with left edge of 
page. 


)tes: • The default left margin for Epson FX80 printers only*, is 

.75 inch. The different default is diie to the inability to 
print on the true left edge of form feed paper using this 
printer. 


• All horizontal formatting parameters and commands (Tab, 
Line Width, \hld, \>, etc.) are specified relative to the 
left margin. Thus, if the left margin is changed, all the 
other parameters will reflect that change. If you specify 
a Line Width (LW) of 6.5 inches and a left margin of 3 
inches then you have actually requested a right margin of 
9.5 inches which is of course too large for many printers. 
The left margin cannot be directly changed within a text 
file; however, the left indent command (\>) can provide 
the same effect. 


• ..+LM 0 may cause slanted characters at the beginning of 
a print line to ^disappear” since such characters slightly 
overhang the margins. We recommend, therefore, using a 
very small left margin (e.g. +LM .05i). 
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, 


Suggestions: 


I 

Use the left margin to horizontally reposition text on ^ 
page. Use \> embedded command to change the 
indentation from the left margin and effectively change 
the left margin from within the text file. 




y-IP. 


t 

fe,: 


m 


E 
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N 
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> -— Last Page 


Last Page —— LP 


fleet a portion of the document to be printed. 




+LP <Page Number> 

Stop printing after the indicated numbered page is 
printed. The Pfont program will terminate following this 
page. 

-LP 

Normal printing, do not stop printing until the end of all 
specified files. 


allies: <Page Number between 1 and 9999> 

The page number that is the last page to be printed. 
Any integer between 1 and 9999 may be specified. 


xamples: . +lp 4 

Page number 4 be the last page printed. 

• -LP 

Normal printingf end printing after the last page. 


otes: LP works with the same number that would be printed 

on a page; i.e., the one specified with the Initial Page 
Number (PN) parameter. 


ilggestions: Use this parameter in conjunction with the First Page 

(FP) parameter to select one, or a sequence of pages to 
be printed. This is particularly useful if you need to 
reprint a portion of a document, but not the entire 
document. 




Part P - 


Printing with Fonts 


IW — line Width 

Specify the maximum width of a printed line. 


Line Width — 





CS1SC!]I^B3[S5B113iii* 


easure> 


Usage: 


V alues: 


Ixamples: 


+LW <Horizontal Measure> 

Indicate the width of printed lines of text. The width || 
measured from the left margin. Thus a left margin of I 
inch (4-LM li) and a line width of 7 inches (+LW 71) 
yields a line end of 8 inches. The line width is of 
particular importance for \j, \c and \r embedded 
commands. Turning off the line width is not allowed; 
neither —LW or 4-LW Oi would allow any characters to 
be printed. 

<Horizontal Measure between 0 and 8 inches> 

The width of the line in inches. The sum of the left ^ 
margin (LM) and the line width (LW) should not exceed | 
8 inches for narrow or 13.6 inches for wide printers. If it | 
does, an error message will be displayed and the margin - 
set to the minimum. 

I 

I 

+LW Bi +LM l.Bi 

Line width of 5 inches, left margin 1,5 inches, implied lirie end 
at 6,5 inches from left edge of paper, 

+LW 8i -LM 

Line width of 8 inches, no left margin (0 inches), implied line 
end at 8 inches from left edge of paper. 


otes: • If a printed line exceeds the line width, a message will be 

displayed on the user’s terminal and the line will be 
truncated. No justification will occur for such a line (see 
\j embedded command). This will not happen in word 
wrap mode. 


t S*am^3<yrU allows the definition of characters with negative 
margins. That is, the print head moves backward before 
or after printing the character. Justification and word 

wrap are based upon the print head position, thus 
characters will extend slightly to the right of the printed 
line. This is generally desirable, occurring mainly for 
slanted characters. However, you cannot use the 

complete line width of the printer, you must leave 
• enough room for the overlap (usually 1 or 2 dots in the 
distributed fonts). Oh 8 inch printers, the effective right 
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margin, Line Width (LW) + Left Margin (LM) should be 
set to a maximum of 7.95 inches, A warning message 
will be displayed if this may be a problem. If the right 
margin is too large, slanted and overlapping characters 
may not be printed if they are to appear at the end of a 
line. 

The left (\>) and right (\<) indentation commands can 
be used to effectively change the line width from within 
the text file being printed. 
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NC —— Number Copies 

indicate the number of copies to be printed: 


Niuuber Copies — NQ 


•m- 





Usage: 


’^alues: 


xamples: 


otes: 


tween 0 and 9999> 


defauli: +NC 1 
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• +NC <Integer between 0 and 9999> 

Print the indicated number of copies. Normally only om 
copy is printed (this means the document is printed 
exactly once). If 4-NC is used, exactly the same 
document is printed the indicated number of times. Page 
numbering, formatting etc. will be identical. 

• —NC or +NC 0 will indicate that no printing is to occur 
This is not a good idea, and an error message will be 
displayed if you ask for 0 copies, (see 4'SD parameter if 
no printing is desired). 

<Integer between 0 and 9999> 

The number of times the document is to be printed, 0 is 
not recommended! 

+NC 6 * 

Print 5 identical copies of the document to be printed. 


• The special file name ‘loop:’ can be used with the +F1 
parameter to print multiple non—identical copies of a 
document (e.g. consecutive page numbers). 



' V.- 


ggestions: 


+NC can be used with any other parameters, including 
multiple file names. K 4-NC is used with the ‘con’ or 
‘tty:’ file name, you will be prompted for input for each 
copy. Previous input cannot be reused. 

Useful for printing a ‘carbon copy’ of a letter, multiple 
copies of return address labels, etc. 


{ 

\ 
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Not On First Page 


Not On First Page — NF 


PP-T 

Srol the printing of Header lines and Footer lines on the first page. 




+NF.or.-Nf 


default: —. 


Ige: 

tete! 




W'" ■ 


+NF 

Disable printing of the Header Line (HL) and Footer Line 
(FL) on the first page of text only. Any header and 
footer specified by HL and FL parameters will be printed 
on the second and subsequent pages. 

-NF 

Retain the normal operation of the Header Line (HL) and 
Footer Line (FL) parameters. 


'alues: 


none 


bcamples: . +nf 

Disable printing of header and footer lines on first page only. 
. • “NF 

Normal printing of header and footer lines on all pages. 
fotes: • TM and BM are not affected by NF. 


I • Notice that turning this parameter on actually turns off 

headers and footers on the first page. The built-in 
setting is off, thus normally any headers and footers will 
appear on the first page. 

Uggestions: Use the -hNF parameter to print letters, and documents 

with a title page where the first page should not have a 
header or footer (e.g. page number), but where 
subsequent pages should have this information. 




o 
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ly — Process FomiFeeds 


Process FormFeeds — P| 


nable/Disable recognition of Control—L characters as page feeds. 



Jsage: 


/ alues: 


^otes: 


uggestions: 


+PF 


Any Control—L characters (ASCII decimal 12) in the text 
will be treated as if they are \p commands. That 
they cause the current page to be ejected and a new 
page to be printed. 

-PF 

Any Control—L characters (decimal 12) in the text are 
ignored. They do not force a new page and are not 
printed. 




none 


• +PF 


Control-L in text will force a new page. 


-PF 


Control-L in text iviU he ignored. 


The PF parameter does not impact the \p embedded 
command. 


—PF is useful for printing assembler listings and other . 
text that may include embedded form feed characters J 
(Control—L). 1 
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i*— Paginate Paginate — PG 

for enabling or disabling all top and bottom margin parameters. 






f 




Enable normal function of the Top Margin (TM), Bottom 
Margin (BM), Header Margin (HM), Header Line (HL), 
Footer Margin (FM), Footer Line (FL) and Page Length 
(PL) parameters. 

-PG 

Turn off (disable) all the top and bottom margin 
parameters (-TM, -BM, -HM, -HL, -FM, -FL, -PL). 
This allows Pfont to follow pagination and margin 
directives from other word processing software. Normal 
text files will print as one continuous stream of text with 
no top or bottom margins. 


alues: none 

6,' 

icamples: . -t-pc 

Normal pagination. 

• -PG 

Text will be printed continuously with no top or bottom margins. 


Dtes: none 

Iggestions: Normally use the default, +PG. Use —PG if your text 

already includes page breaks, top and bottom margins, 
headers and footers or if you do not want pagination of 
any sort. 
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PL — Page Length 


Page Length . 


Specify the length of a printed page including top and bottom margins. 


i i ♦. 11, i.. ' I, ♦ 1 7 . ' i ! II t 
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Usage: 


Values: 


Notes: 




• +PL <Vertical Measure> 

Indicate the total length of a page from the top of t 
paper to the bottom of the paper. A new page will 
printed after the specified number of vertical inches 
been printed (including top and bottom margins). Th| 
page length must exceed the sum of the top and botton^ 
margins. 

. -PL 

Perform no pagination (same as +PL Oi). There will be 
no page breaks and no bottom margin. The top margin 
on the first page will be printed however. 

<Vertical Measure between 0 and 425 inches> 

The height of a page in inches. +PL Oi is equivalent to 
-PL. 


Examples: . +pl 4i 

Print using 4 inch pages. 


-PL 

No pagination. 

Maximum page length is 425 inches, however —PL (+PL 
Oi) specifies no paging and thus an infinitely long page 
length. 


Suggestions: • Use short pages for printing mailing or diskette labels. 

For example, address labels are often 1 inch high 
(including a small gap between successive labels on 
continuous forms), so ‘+PL li’ should be used. 

• —PL (+PL Oi) is useful for continuous printing without 
any page breaks. 
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Initial Page Number 


Initial Page Number — PN 


the number to be associated with the first page. 


re Number> w —PN 


default: 









■it. ■ 


xamples: 


4;:y 

► ' -r 


^otes: 


uggestions: 


• +PN <Page Number> 

Normally, if pages are numbered, the numbering sequence 
will begin with page 1 (—PN or +PN 1). If you require 
a different starting page, specify that page number by 
using +PN. 

. ~PN 

Use the default initial page number (1). Same as +PN 

1 . 

<Page Number between 0 and 9999> 

An integer which is the page number to be associated 
with the first page. The page number must not exceed 4 
digits and must be a positive number. 

. +PN 5 

Begin numbering the first page as page number 5. 

• +PN 60 

Begin numbering the first page as number 50, 

The page number is only printed if the embedded 
command \s# is used to indicate where the page number 
is to be printed on each page. Page numbers are 
generally printed in either the header line or footer line, 
but can be printed anywhere in the text. First Page 
(FP), Last Page (LP) etc. will refer to the numbering of 
pages specified by the PN parameter. The page number 
determines whether odd or even header and footer lines 
will be used for a given page. 

• The initial page number parameter is convenient for 
printing different sections of a document using different 
”runs” of Pfont. For example, if the first section covers 
pages 1 to 12 then specify +PN 13 when printing the 
next section. Page numbers must be integers, however a 
compound page number such as P—89 can be printed by 
a string such as P—\s#. 

• To achieve numbered pages (in this case the number 

centered at the bottom of a page), use: 

+FL '*\c\»#*' or 





o 
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+FL "VcPage \b#" 

to print the word ‘Page’ followed by 
number. 


the 


actual 
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~ Page Pause 

SSa.-;: ' 


Page Pause —- PP 


^oI automatic and manual loading of paper. 





+PF 


or 
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default ^ 
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lage: 










+ PP 

Manual paper feed. Printing will stop at the end of each 
page and the printer will beep to indicate end of page. 
When any key oh the keyboard is depressed, printing will 
resume. 

-PP 

Normal, continuous form paper feed. The printer will 
continuously feed paper and print each page until the 
end of the document. 


alues: 


none 


camples: . +pp 

Printer will pause after each printed page. 

. rP? 

Normal, continuous form printing. 

3tes: • +PP disables the printer’s paper out detection circuitry. 

(Epson MX series printers don’t allow this in their 
graphics mode, so if you wish to supply paper manually 
then you must manually disable the paper out detection. 
This is done by either setting the internal printer switch 
which disables paper out detection or by placing a piece 
of paper over the paper out detector on the left side of 
the printer platen). 

• The printer may be turned off to allow you to more 
easily change paper following a page pause, make sure to 
turn it back on. 

• You should probably use —TM and +BM 2i when using 
+PP because it is difficult to position single sheets of 
paper in the printer to properly print at the top of the 
paper. 

m 

^ The Control—E interactive command (see section P.4) can 
be used to turn this parameter off during printing. 







Suggestions: 


0 
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Use this parameter when feeding one sheet 
time. For example when printing on 
letterhead, or preprinted forms. 


of paper at a 
bond paper, 
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'■— Bough Draft 


Bough Draft —- BD 


the quality and speed of printing. 
^ 4-jlt) <Int 


tage: 


default 


m +RD <Integer between 0 and 6> 
or <integer between 0 and 2> 

Select a rough draft printing mode (between 0 and 6 for 
FX version, 0 and 2 for MX version). 

. -RD 


Do not use any rough draft mode, use the normal, high 
quality printing (same as +RD 0). 


Uu6S: • <integer between 0 and 6> 

Epson FX version: 

0 Normal printing (240dpi horizontal, 216dpi vertical, 
even/odd passes, same as —RD) 

1 Normal printing (240dpi horizontal, 216dpi vertical, 
consecutive dots may not be printed) 

2 MX printing (120dpi horizontal, 216dpi vertical) 

3 Rough (120dpi horizontal, 216dpi vertical, consecutive 
dots may not be printed) 

4 Rough (120dpi horizontal, 72dpi vertical) 

5 Rough (120dpi horizontal, 72dpi vertical, consecutive 
dots may not be printed) 

6 Sandpaper (60dpi horizontal, 72dpi vertical) 


• <integer between 0 and 2> 

Epson MX printers: (substitute 144dpi vertical for 216dpi 
and 144dpi horizontal for 120dpi for Gemini, C.Itoh 
printers) 

0 Normal printing (120dpi horizontal, 216dpi vertical) 
same as —RD. 

1 Draft printing (120dpi horizontal, 72dpi vertical) 

2 Sandpaper printing (60dpi horizontal, 72dpi vertical) 

:amples: • +rd 2 

Cause all printing to be at rough draft level 2, 

• -RD 

Highest quality, final copy printing, 

>t6S: More fonts fit into memory during rough draft printing 

(when vertical resolution is reduced), further increasing 
printing speed. 









Suggestions: 
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Use the higher numbered rough draft modes for faste 
printing in order to preview documents for pagination 
page layout etc. Print your final copy, using the t( 
quality. For some applications, rough draft modes 
suffice, (See Screen Display (SD) for other draftli 
possibilities). 






• See the \d embedded command and section P.4 fo|] 
changing rough draft modes for portions of a document. 
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S,. . . . 

f —- Reverse Vertical Enable * Reverse Vertical Enable — RV 


i^able/Disable reverse vertical paper motion. 



1^:: Indicate to Pfont that vertical motion commands causing 

V backwards motion should be allowed. This will only work 

^ on printers that allow such motion, if enabled for other 

printers, errors will occur. 

^ Do not allow reverse vertical paper motion, 

allies: none 


xamples: • +rv 

Pfont will attempt to process commands such as \v.5i, 

. -RV 

Commands such as \v—l,25i will be ignored and an error 
message will be displayed, 

[otes: # This feature can be enabled or disbaled regardless of the 

type of printer being used. However, it should never be 
enabled unless you are using a printer that allows 

backward paper motion (such as Epson FX80). The 
default setting for this parameter depends on the printer 
type specified in the profile (see appendix 5). If 

an FX80 printer has been specified, then +RV is the 
initial (default) setting; in other cases, —RV is the 

default setting. This capability allows exact interline 
spacing regardless of fonts and can be used in 

conjunction with vertical marking and positioning 
commands to produce more complicated printing. 

• An Epson FX80 printer with auxiliary tractor feed cannot 
perform backward paper motion (apparently the paper 

will jam). 


• Use this feature to eliminate the interline spacing 

limitations discussed in section E.2. . 

9 

• The use of +RV on a printer that does not support 
reverse paper motion is likely to result in severe printing 
and formatting errors. 






Suggestions: 

> 
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• If distortion occurs due to reverse paper motion, then use 
-RV. 

Using a combination of \n to mark vertical position and 
\v to move the print head vertically, you can produce 
more complicated equations and, with difficulty, multiple 
columns. 




'* •tf.'’ Jls 
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Screen Display . Screen Display — SD 

Preview, on the terminal, the text to be printed. 







I iiiii li iiii 1111 HI mil I m u fci ii Id 

4-SC or -SD 




.11. t.....V. V ^ '7 *♦ iT. rr nr r i.r/i im 'ffr m. ' . t fi i wri ' 


TTrrnTrrnrnrrrrrrrTrrr 


—St) 


Values: 


+SD 

Display output on the user’s terminal in a manner similar 
to that in which it would be printed. Do not actually 
print. 

~SD 

Normal printing — do not preview the document. 


none 


V ■ 

Examples: 


•jv w 


+SD 

Preview document on terminal, no printing. 
“SD 

Normal printing, no preview. 


Notes: • When using +SD, output is displayed at the user’s 

terminal rather than being printed. The output 
displayed with the arguments for embedded commands 
visible. For example, if \f3 appears in the text file, the 3 
will appear in the processed text during screen display. 


• If +SD is indicated, no fonts will be loaded in memory in 
order to increase the speed of previewing (the information 
normally loaded in memory is not used in this mode). 


• The Screen Display parameter will preview line width 
problems and page breaks, but does not display on your 
console an exact view of printed output (i.e. no visual 
font changes or proportional spacing). 

• +SD causes display output paging (the —more-“-“ 
message) to remain in effect. Paging is normally turned 
off during printing. 

Suggestions: +SD is a quick way to determine whether any command 

or formatting errors have been made and to preview a 
document. See the First Page (FP) parameter for an 
** even quicker way to check for errors. 
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IF — Interline Space 

Jontrpl the white space between printed lines. 


Interline Space — SP 





Jsage: 


^ alues: 


Examples; 


otes: 




SP 


default: +SP .046 




m 

wvw..r- “ 


• +SP <Vertical Measure> 

Indicate the amount of white space to appear between 
printed lines. The distance being measured is from the 
bottom of one line to the top of the next. 

• ^SP 

Indicate that no white space is to appear between printed 
lines (same as +SP 0). 

<Vertical Measure between 0 and 426 inches> 

The amount of white space to appear between printed 
lines, measured in inches. A value of 0 (or —SP) will 
cause lines to be printed as close to each other as 
possible (see section E.2 for details). 

• +SP .5i 

Leave .5 inches of white space between printed lines. 

. -SP 

Leave no white space between printed lines. 

• The \1 embedded command allows changing of the 
interline spacing from within the text file. \1 uses the 
value of +SP as its initial value. +SP can not have a 
negative value, however \1 may be used with a negative 
value. 


w 


M* 


ij* 




m 


0 


'M 




Cgestions: 


• The actual white space is measured in vertical printer 
dots (1/72"*^ inch for Epson MX,RX,FX printers). The 
specified inches are converted to dots by ignoring 
fractional dots. 

• Depending upon the heights and depths of fonts on 2 
successive print lines, more white space than requested 
may appear. A message will be displayed at the end of 
all printing to indicate this has occurred. See section E.2 
for a description of interline spacing and +RV for finer 
interline spacing control. 

Use the \1 command to modify interline spacing within 
your text to be printed or use the \v+ command to 
override interline spacing for individual lines. 










o 
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Ws. Substitute 


Substitute — SU 


substitution strings for \8 commands embedded in text files. 
+Sl) <i[i8t of or St) defa\ 


default: —I 


fiage: 




^ - 

1-- ■ 


lvalues: 


xamples: 


lotes: 


uggestions: 


• +SU <list of 1 to 10 strings> 

Specify the contents and order of strings to be 
substituted for \8 commands. The first string corresponds 
to \s0 in the text, the second to \8l, etc. 

• -SU 

Specify no substitution strings, any \8 strings in the text 
will be flagged as errors. 

<list of 1 to 10 strings> 

1 to 10 strings may be listed. Each string may include 
any embedded command including the \s command. If a 
string includes spaces or special Pfont characters (‘<k’, 
etc.) surround the string with double quotes Each 

string must be no longer 135 characters. The strings are 
numbered 0 to 9 to allow easy specification of a 
maximum of 10 strings. 

• +SU **The \f2Fancy FontTMXfO System" "October 1, 1901" 

Substitute the string The System for each occurrence 

of \s0 m the text file. Notice the change of font. Also 

substitute the date October 1901 for each occurrence of \8l 
in the text file, 

• +SU Xyzzx Xylophone "Zebra?" 

Substitute Xyzzx for \80, Xylophone for \8l and Zebra? for 

\b2, 

• If an error occurs in a substitution string, the error 

message may be displayed on the screen prior to the 
actual printing of the line on which the error occurred. 

• CP/M users: if the +SU parameter is specified on the 

CP/M command line, the first word of each substitution 
string will be capitalized; all other words in the string 
will be all lower case. To retain your desired 
capitalization use interactive mode or parameter input 

. file. 

+SU and \b commands can be combined to associate, 
styles with paragraphs or other sections of text. Define a 
string containing all the embedded commands (fonts, 



o 
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underlining etc.) which define up to 10 styles to be used 
in your documents. Then use the appropriate strings at 
the start of each paragraph, section, etc. Other uses 
include specification of frequently used phrases and 
information that you may wish to change each time a 
document is printed (e.g. date, addressee). 
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'B — Tabs " Tabs — TB 


F, 

'o clear or set evenly spaced or explicit tab stops. 





Jsage: . +TB <list of 1 to 15 Horizontal Measures> 

Set up to 15 tab stops. 

. -TB 

Do not process any tabs; if a tab is detected in the text, 
an error message will be displayed on the terminal. 

/^alues: <list of l to 15 Horizontal Measures> 

(between 0 and 8 inches) 

The Horizontal Measures specify tab stops. If only 1 
number is given, then up to 15 evenly spaced tab stops 
will be set (the spacing will be the indicated number of 
units). If more than one number is indicated, then a tab 
stop will be set at each of the indicated locations. The 
numbers must be in increasing order and must be la^ 
than the line width. All tab stops are set relative to the 
left margin. The maximum setting is 8 inches (13.6 
inches for wide printers). 

ixamples: • +TB .5i 4.25c 701d 

Set S tab stopsf the first 1/2 inch from the left margin, the 
second 4,25 centimeters from left mar gin j etc, 

. +TB .8i 

Set 15 tab stops, ,8 inches apart (i,e, ,8, 1,6, 2,4 inches 
from the left margin), 

lotes: • Remember that the tabs are measured from the left 

margin and that tab settings do not change when 
indentation is changed (\>). 

• Tab stops set to the left of the current left indentation 
setting are ignored. A tab in this area will cause the 

print head to move directly to the indent location. 

Uggestions: See \t, \h and \i commands for use of tabs and for tab 

alternatives. 
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M — Top Margin 


Top Margin — TM 


pecify the amount of white space to appear before the top of the main 
ody of text on a page. • 



<Vertical Measure> at — 


defavlU +TM ,751 


Fsage: 


alues: 




• +TM <Vertical Measure> 

The amount of white space to place at the top of each 
page. This is the distance from the actual top of the 
page to the top of the first line of text on the page 
(other than a header line). 

. -TM 

Do not leave any white space at the top of each page, 
no top margin (same as +TM 0). 

<Vertical Measure between 0 and 425 inches> 

A number between 0 and 425 inches. This is the 
amount of white space to be left at the top of each page. 




xamples: 


otes: 


^gestions: 


. +TM 3.6i 

Leave a S,5 inch top^ margin on each page, 

• -TO 

No top margin, 

• The top margin is actually measured in vertical printer 
dots (1/72"** inches for Epson MX,RX,FX). The number 
of inches is converted to dots; any fractional dots are 
ignored. 

• If there is no top margin (-TM), then there can be no 
Header Line (HL). 

. If HL is specified, the top margin must be large enough 
to accommodate the height of the header line plus the 
header margin (HM). 

If you change the Page Length (PL) you will probably 
want to also change the top and bottom margins (TM 
and BM). 


1 
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fU — User Defined Units • User Defined Units — UU 




lefine the ‘u’ unit of measure. 

TT t.. . j i. lu.. i. Ii .. 1.1 » ■ . ' > r. ni»r r . ' ... i .. i. i ' .,«ii in >i > 





pSi 


+UU 
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• +UU <list of 1 or 2 Real Numbers> 

Specify the horizontal and vertical printer dots for the ‘u’ 
unit of measure. 

. -UU 

Do not define the ‘u’ unit; in this case ‘u’ will not be 
processed as a unit. 


/^aluGSI <list of 1 or 2 Real Numbers between 0 and 9999> 

- If one number, then the ‘u’ unit is defined to be this 

number of printer dots both vertical and horizontal. If 
two numbers, the first is the definition of the "u’ unit for 
horizontal measures (number of horizontal dots per unit), 
the second is the definition of the ‘u’ unit for vertical 
measures (number of vertical dots per unit). CP/M 
users: you must use integers in place of real nxmijyt^ 
with this parameter — thus the ‘u’ unit may be only 
approximate. 


Examples; . +UU 4.724 2.835 

This defines to be millimeters for the MX80 printer (4^124 
horizontal dots per unit is approximately equal to 120 dots per 
inch). In this case \h+3u would advance the print head 3 
millimeters, 

• +UU 120 72 

Defines inches for the MX version of 9am^S*<yni (that is^ ‘u^ is 
now identical to H'), 

• +UU 12 72 

Defines ^u* as pica characters for horizontal measures and 
inches for vertical measures. 

MX printers have a positioning resolution of 120dpi 
horizontal, 72dpi vertical (smallest unit of Pfont 
measurement, although actual print resolution is 216dpi). 
FX,RX printers have a positioning resolution of 240dpi 
horizontal and 72dpl vertical. 

Use this feature of Pfont to define your own units of 
measure based on the resolution of the version of 
S'tyrti you are using. Notice how this was done in the 

example above for millimeters. 


Jotes: 


uggestions: 
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.4 COMMANDS WHILE PRINTING 

bese commands are only available when printing is in progress. It takes 
ttlo while to get used to these since there is not immediate response whei^^ 
ae of these commands is entered. Type any of these commands onci 
riniing has started^ however the command will not be acted upon until ihi 
art of printing of a new print line. Furthermore, the print line must be ir{ 
le main body of text, i.e. not the header or footer line. These commandi 
squire a bit of patience but nevertheless can be quite useful. 

•ontrol—Z’ (CP/M, use ‘Control—C’) Stop all printing and exit Pfont. 
Use this if you want to immediately quit printing. Control-Z 
can be used to temporarily stop printing to allow paper to be 
repositioned. Make sure to answer ‘n’ when asked if you really 
want to quit. Press one additional key to continue printing. 

'ontrol—N’ (CP/M, use ‘Control—P’) Stop printing current page and skip 
to the next page. Use this command to advance to the next 
page when the current page has an error or is otherwise not 
worth printing. If you know in advance that you want to use 
Control—N, try using the FP and/or LP parameters for better 
control. 


ontrol—D’ Cause subsequent lines to be printed using a different 

horizontal draft mode. You will be prompted for a single digit 
with which to indicate the desired horizontal draft mode. See \d 
embedded command for details of horizontal draft modes and 
their selection, section P.1.2. 

mtrol—E’ Pause after the current page has finished printing. If 

+PP is in effect, this will pause one last time and then will 
disable subsequent pausing. Paper out will not be detected for a 
paused page. 

utrol—F’ Stop printing the current file and skip to the next file. 

Use this if you notice errors in the current file and wish to 
continue printing the contents of any remaining files. 

atrol— C’ Immediately quit printing (CP/M, see ‘Control—Z’). 


ERROR INTERACTION 

e Pfont is quite flexible in allowing input to be specified in a variety of 
. it is difficult for Pfont to predict the cause of parameter errors. 
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pore, Pfont provides dear indication of where an error occurred, the 
detected and. a choice of options as to how to proceed. The 
deal with any input that follows the error and generally allow 
lion of new input, selective deletion of existing input, continuing as if 
Slfwere no error, or restarting from the beginning. Dealing with errors is 
le^ if one parameter and one value is typed on each line. It becomes 
|||complicated when the command line interaction, parameter input files 
Multiple parameters on a line are used. 




fhen an error is encountered the unexpected input, as indicated in the 
lor message, is ignored. Any remaining input can still be processed if 
M BO desire. You can insert, delete, continue with the remainder of input 
^backup to leave a parameter (such as a font list). <E> is added to the 
)rmal prompt to indicate that you are currently recovering from an error 
therefore have some special options. 




he error recovery options are: 




formal Typing: Insert and continue normal processing (type the input to 

PI' be inserted). 




bntrol—B: Leave the current parameter and continue with other 

K error correction options. 


ontrol—D: Delete the next input word and continue with other 

error correction options, A final Control—D will stop input from 
the current parameter input file (if any). 

etum (>): Process remaining input and return to normal 

interaction. 

Dntrol— X: Discard all remaining input on the line containing an 

error (also stop input from parameter input file) and return to 
normal interaction (a combination of multiple Control—D’s and a 
Carriage Return). 

the following transcript of Pfont error interaction, user input is 
iderlined, ^ is ’carriage return’ and commentary is m small italics. 
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'ont file *Freiichl2’ not found. 

’Frenchl2* has boon discarded: 
Lesaining input: 

Ronnbl2 +Rd X Y +P1 6i 


j> Pfont Sample.if -t-fo Frenchi2 RomnB12 -trd X Y +pl 6i 

Invoke Pfont to print the contents of fiU 
/Sample.ff* using 2 fonts^ rough draft printing 
and a page length of 6 inches, 

Hont: Print with Fonts ... 

Copyright (C) 1084 SoftCraft, Inc. Pfont introductory messages, 

»asple.ff ’t’fo Frenchl2 Ronnbl2 'i’Rd X Y -i-Pl 6i 

^ Frenchl2 is an error (font not found). The 

input line is echoed with a pointer to the error. 

Font not on disk. 
Erroneous input discarded. 
The unprocessed input is displayed 
and some help is provided indicating 

error recovery options. 

nsert input or press ’Return* to continue 

lontrol-D to delete next input word, Control-B to backup 

ontrol-X to ignore all remaining input and continue 

0 Fonts<E> ^ Prompt indicates error recovery in progress, 

font file names expected. User types > to 

continue processing input. 

Ronnbl2 +Rd X Y +P1 6i Another error, X is wrong. 

An integer is required for RD parameter. 

ateger was expected. 

'X* has been discarded, 
amaining input: 

Y +P1 6i 


sert input or press ’Return’ to continue 
ntrol'D to delete next input word, Control-B to backup 
utrol-X to ignore all remaining input and continue 
Rough Draft<E> Control-D The user decides to give up with 

rough draft and to clean up by deleting 

the next input, 

tmaining input: Now only PI parameter left. 

^P1 6i 

eert input or press ’Return’ to continue 

ntrol-D to delete next input word, Control-B to backup 

ntrol-X to ignore all remaining input and continue 

Rough Draft<E> Control—B Since user decided not to use 

rough draft, Control—B *backs out' of 
the rough draft parameter. 

> jX User presses ^ to continue by processing 

remaining input (i.e. the Page Length parameter.) 
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part E — Editing Fonts 


Sfoiit can be used to create new characters or edit characters in existing 
blits. For example, you can use Efont to create a logo or other special 
graphics symbol; the gray shading in this manual’s command description 
pieces was created in this way. Also, you can create new characters such 
Ki foreign characters or accents; users have created Sanskrit and linguistic 
gjphabets. Furthermore, you can edit characters in existing fonts in order 
to " achieve special effects or to suit your taste. 


Any character in any font set can be edited using any standard text editor. 
Characters or logos can also be created using a text editor and then 
Installed in a new or existing font set using Efont. The basic operating 
sequence for editing a character is 1) create a text file for a character 
using the Efont edit command, 2) get out of Efont and edit the character 
using your favorite text editor, and finally 3) return to Efont and replace 
the original character with the modified character using the Efont replace 
command. 


A character is defined by a pattern of dots (sometimes referred 
pixels). Different printers print dots at different densities. For example, 
the Epson MX allows printing of as many as 120 dots per inch horizontally 
and 216 dots per inch vertically while the Epson FX and RX can print 240 
dots/inch horizontally and 216 dots/inch vertically. 


Consider the following two characters: capital ‘A’ and lowercase ‘p’ taken 
from the Roman 10 point font in the Epson FX version of 
They are shown here in magnification to illustrate the dots that make up 
the characters. 



••• 

••• 

• •• 

• •• 

• •• 

• •• 

• •• 

• •• 

• •• 

• •• 

• «• 

•• 

•• 

•• 

•• 
•• 
••• 


•• 



- ytop for ‘A* - 27 


- jrtop few ‘p’ » 19 


' charoctor booelino 


- PfoDi oBderUn* kKotloB 


The vertical bars on the sides of the characters represent an imaginary 
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>ox’ in which the characters are positioned. When Pfont prints a 
squence of characters it places a character so that the left edge of its box 
jst touches the right edge of the .box of the preceding character. For 

xample^ the left edge of the ‘p’ box above touches the right edge of the 
box (in this picture the two boxes share a vertical line). The spaces 
round the character within the box are called the character margini 
sometimes called sidebearings). In this example, the ‘A’ has a left margin 
f one dot and a right margin of two dots (the faint dots appearing on the 
aseline have been included to help count empty dot positions). The ‘p* 
as a left margin of one and a right margin of one. 

. is possible for a character to have negative margins, either left or right, 
legative character margins are useful in a variety of situations. A 
haracter with a negative left margin will ‘back up’ the print head before 
rinting the ink for the character. Similarly, a negative right margin will 
luse the print head to back up after printing the character. Slanted 
laracters fit best together with negative margins because of the ‘overhang’ 
slanted characters. Even a vertical character such as ‘f has right 
erhang that calls for a negative right margin for best fit. Although 
gative margins are allowed, the overall box width of a character cannot 
less than zero. Zero—width characters are allowed, however, and are 
eful for creating accent characters that are to be overprinted over other 
ters. Here you might design an accent character that has a large 
gative left margin so it reaches back over the previously typed character 
d that has a right margin large enough to bring the print head back to 
lere it was before the accent was printed. 

e preceding discussion addressed the horizontal placement of characters 
a line; we also need to discuss vertical placement. The numbers printed 
the right of the vertical bar next to the ‘p’ illustrate the vertical dot 
nbering method used in fonts. By convention, almost all of 

( fonts in the Epson MX and FX versions of have their 

elines at vertical location seven (section E.2.1 gives some justification for 
choice). Counting up from seven we see that the topmost dot in the 
' is at location 27. We call this the yiop value for ‘A’. Similarly, the 
> value for the ‘p’ shown above is 19. These three numbers — left 

rgin, right margin, and ytop-and the dots that make up the 

? racter completely define a character. Efont creates and reads files 
i taining this information in editing old characters and creating new 
iracters. We call files of this type ‘.edf files because Efont usually 
f es files with file name extensions of ‘.edf, ^ in ‘a65.edP (‘edf is short 
edit file’). The ‘.edf file for the ‘A’ character above is as follows. 
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a 127 












* 


4(*4t 
3k ik>k 
* Jk* 

>k *★ 

* Jk* 

★ ** 

♦ ■ Jk* 

★ ** 

* ** 

* ★* 

* ** 

* ** 

* ** 

* ** 

* ** 

** *** 

******* *****^*]k 


"he first number in the file, 2, is the left margin, the second number, 1, is 
he right margin and the final number, 27, is the ytop value. The astt rjste 
epresent the dots in the character. If you ask Efont to edit the ‘A’ 
haracter in the Roman 10 point font it will create a text file that looks 
ke this. You can then edit that file, changing the margins or ytop value 
0 modify the horizontal or vertical placement. You can also move, add or 
emove asterisks to change the printed form of the character. After that 
he Efont replace command can be used to install the modified ‘.edf file as 
character in the old font or in a new font. 


Fote that vertical placement really has no absolute significance; it is only 
^hen a font at one vertical location is printed on the same line as a font 
t another vertical location that the difference in vertical location is 
oticeable (except for underlining). For example, a superscript 10 point 
mt is exactly the same as the normal 10 point font except that ail of the 
haracters have their baselines at a higher location (approximately 18 for 
lie Epson MX/FX version instead of 7 for normal fonts). The way we 
lake a superscript font from a normal font is to increase the ytop value of 
Etch individual character in the font (the updoxvn command conveniently 
oes this for an entire font). A subscript font, of course, has its baseline 
t a location lower than normal fonts. Section E.2.2 has a more complete 
iscussion about the effects of relative vertical location of* characters and 
>nts. 


>ne common application of Efont is to create special foreign, characters, 
he following transcript demonstrate the procedure for adding an accent to 
a ‘n’ in the 12 point Roman font. The small amount of user input is 
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underlined and *>’ corresponds to a press of the RETURN (or ENTER) key 
on the keyboard. 

‘A> «font> 

Efont: Edit Fonts.Ttrsion n.nn (Epson FX> 

CopTright (C> 1084 SoftCraft. Inc. 

CoMiand (ons of: l,s.p,«,r.d,n,t,z,a,u.q.7»l load a font 

Font sot fils nMio> ronnl2. fon.^ type the font file name 

ROMAN 12PT. 4/13/84. COPYRIGHT (C) 1084 SOFTCRAFT. INC. 

Top Row«l. Bottom row»0 

Blank Points (top>*4, blank points (botton>«0 

Conmand (ons of: l,s,p,s»r,d,n,t,£»a,u,q,7)>s edit a character 

Starting ckaractsr (0 to 127)> 110A ‘n* is decimal ASCII 110 

Ending charactsr (dsfault 110>>£ accept the default to edit only the 

Fils nams for sdit output (dsfault all0.sdf)>A accept the default file name 
allO.sdf 

Connand (ons of: l,s,p.s,r.d»n,t»£,a,u,q,7>>q exit Efont 

A> 

This will produce a DOS file named ‘allO.edf on the current drive 
containing the following digits, asterisks and spaces. 

1 2 22 



4c 4c 4c 

«*** 

4c 4c 


4c4t4c 


4c 4c 4c 

4c 41* 

4c4c4c 

4c4c4t 

4c 4c 4c 

4c 4c 4c 

4c4c4i 

4c 4c 4c 

4c 4c 4c 

4c4(4c 

4c4c4c 

4(4c4c 

4c 4c 4c 

4c 4c 4c 

4c 4c 4c 

4c4c4c 

4c 4c 4c 

4c 4c 4c 

4c 4c 4c 

4c4i4c 

4c 4c 4c 




I'se your word processor or text editor to modify the file so that it looks 
IS follows. Asterisks have been added over the ‘n’ and the ytop value has 
>een changed to account for the increased height of the character. 



Part E — Editing Fonts 


2 31 

t ¥* 

4t* 4t3|(4(4t]|t4c 

4i4i 4(«* 


s>.; 

.4l4(4(4t)ic4( 4c**i|(4( 




» . rs‘V Jl 


»■ 



. 

. --t 

V ^ . V 

-Sfe 

'rx 

« v“’^ 


*4t4( 4c 
4c4(4i4c 
4t 4c 4c 4c 
4(4c4t 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c4c4( 

4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 


4c 4c 4c 
4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c4c4t 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c 4c 4c 
4c4c4c 


4c 4c 4c 4( 4c 4c 4c 4c 4c 4c 4c 4c 4c 4c 4c 4c 4( 4c 


Now reenter Efont and add the modified character to the romnl2 font. 
^■We will map the new character to the ‘"N’ (control—N) key to differentiate 
it from the normal ‘n’ character 


A>«fon^ 

Efont: Edit Fonts,yaroion n.nn (Epson FX> 

Copyright (C> 1984 SoftCraft, Inc. 

Couand (ona of: l,s,p,a,r,d,B,t,z,a,u.q,7)>l 

Font sat f ila naMa> roBnl2. f on> load the "font again 

ROMAN 2PT. 4/13/84. COPYRIGHT <C) 1984 SOFTCRAFT. INC. 

Top Row*!, Botton row"0 

Blank Points (top)*4, blank points (botton)*0 

Connand (ona of: l,o,p,a,r,d,a,t,z,a,u,q,7)>r replace a character 

Starting charactar (0 to 127) >14^ control-N is ASCII 14 

Ending charactar (dafault 14)>/ replace only one 

Fila nana for raplacanant spac. (dafault al4.adf)> all0.adf>^ 

type the file name rather than accept ^al4»edf* 

allO.adf 

Connand (ona of: l,s,p,a,r,d,n,t,z,a,u,q,?)>B save the font 

Output fila nana for font sat> roBnl2a.fonA give it a new name 

Connand (ona of: l.s,p,a,r,d,n,t,z,a,u,q,7)>q exit Efont 

A> 


A control—N (or ‘\a014’) appearing in a text document printed with this 
new font, romnl2a, will print as ‘fi’. 
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E.1 COMMANDS 


All Efont commands are single letters and do not need to be followed by ^ 
carriage return. Immediately upon typing of the command letter tho 
program will prompt the terminal for any required parameters. The list of 
available commands can be obtained by typing a question mark in response 
to the ‘Command^ prompt. Note, however, that question mark generally 
does not provide help when parameters are being requested by the 
program. Unlike the Pfont program, Efont uses the standard DOS terminal 
interface, so Control—C will exit immediately (when in type—in mode) and 
the normal DOS line editing characters prevail. 

The following list summarizes the Efont commands. They appear here 
ordered according to function while the complete descriptions appear on the 
following pages in alphabetical order. 


1 Load 
8 Save 
e Edit 
r Replace 
p Print 
d Display 
t Test 
z Zap 
m Margins 
u Updown 
a Auxinfo 
q Quit 


Load a font set for editing or inspection. 

Save a modified font set. 

Edit a set of characters by creating a text file for each. 
Replace some characters with their edit file specifications. 
Print a set of expanded characters to the printer. 

Display an expanded character on the terminal screen. 

Test the font by printing a line of text on the printer. 
Remove some characters from the currently loaded font set. 
Modify the margins of a range of characters. 

Specify a value to move characters up or down by. 

Display and/or modify auxiliary font information. 

Exit Efont. 


rhe complete descriptions follow. 
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t- Auxinfo 


Auxinfo — a 


Pbplay information. 






pesaiption: Auxiliary information includes font descriptive commentary and 

the top and bottom blank points values (section E.2 describes 
these parameters). This command prints the current values 
and then asks if they should be changed. Entering a carriage 
return will always leave the values unchanged. Use this 
command also to get a quick listing of defined and undefined 
characters in a font. 


Example: Couand (one of: l,s.p,o,r,d»B,t,x,e,u.q,7>>i 

Curront tbIuob will bo listed to the tenlnel. 

Type <retum> to retain those values or type a new value. 

The file consentary is the following: 

Special characters for use with 14pt. 6/6/84. 

New connentary (128 chars Bax.>> Math and special characters for 
use with 14pt. 6/8/84 . new commentary 
Top row*l, botton row*0 

and *p* are anong the tallest and lowest characters 
The conputed blank points, top (A> and botton (p> are: 
top«2, bottoB*0 calculated values 

The blank top and botton values recorded in the 
file are as follows: 

Mininun nunber of blank points in the top row is 6 
New value (default 2> >> here we leave the values unchanged 

Mininun nunber of blank points in the botton row is 0 
New value (default 0> >A 
The conputed font heif^t is 14 points. 

There are 08 characters defined in this font set, 
and 2 of then are space characters. 

You can ask to see the defined or the undefined characters. 

Do you want to know which are defined (y or n>>n 
Do you want to know which are undefined (y or n>>n 
Connand (one of: l,s,p,e,r,d,B,t,£,a.u,q»?>> 


Notes: • When typing new commentary do not type RETURN until the 

end of the commentary. The input will automatically wrap 
around on your screen if necessary, as it did in this example. 

• The top and bottom blank points are calculated for the 
characters ‘A’ and ‘p’ (ASCII 65 and 112). If the^ characters 
are not present or if ‘A’ is not one of the highest characters in 
the font or if ‘p’ is riot one of the lowest characters in the 
font then the blank points values will not be computed but 

















o 
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you will still be allowed to set them to any value desired. 

• The blank points are calculated for ‘A’ and ‘p’ and then you I 
prompted for new values. The de^lt values provided by the | 
prompts are the values currently in the font and these are not f 
necessarily the same as the calculated values. If you want to | 
change the values to the calculated values you must enter the | 
calculated values at the appropriate prompt. 

9 

• If you accidentally enter this conunand simply type RETURN 
(V’) in response to all of the value-requesting prompts and ‘n’ 
in response to the yes/no prompts. 
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Display 


Display -— d 


^iay an expanded character on the terminal screen. 




ll^riptlon: The expanded asterisk representation of a character is 

displayed on the screen. This command prompts for the 




Example: 


decimal ASCII code of the character to be displayed. 

Couand <on« of: 1 ,s,p,o.r.d.B,t.z,a,u.q,7>>d 
Charmctor nuabor CO to i27)> 14> 

1 2 31 

9(c4citcii( iic4cii( 

4(4t 


'^:A ■ ■ 

-A- ]it]|ej|(4c4r]|c ]|c4ei|c4ci(( 


4c 4c4c4c 
4c4c4c4c 4C4C 

l^t 4(4c4c4c *41* 

*** *** 

*** *** 

*** *** 

*** *** 

*** *** 

> 

*** *** 

*** *** 

*** *** 

*** *** 

*♦* **★ 

*** *** 


*******ii(* *j(c*4(**4(>t(* -- basolino 

CoBaand (one of: l,a>p,a,r,d,a,t,z,a,u,q,7>> 

^lotes: • The first three numbers are the left margin, right margin, and 

ytop values, respectively. 


• The ‘— baseline’ notation indicates the baseline location 
(always at height 7 for the Epson MX/FX/RX version). That 
is, the distributed fonts will be based at this location. This 
has nothing to do with the individual character, but instead is 
simply a number built into the Efont program (and the 
underline location of the Pfont program). Note that the true 
baseline of the ‘n’ character displayed above is actually just 
below the dots pointed to by the ‘— baseline’ notation. 
That is, it is between rows 6 and 7. However, to simplify the 
discussion in this manual we will always refer to the row 

























o 
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contsuning the ‘baseline dots’ as being the baseline. 

• This is similar to the print command, but output is to the 
terminal and only a single character is displayed rather than a 
range of characters. 

• Use the control—S key on your keyboard to control scrolling 
. through the display; hit it once to freeze the display and then 

again to continue. 
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Edit —- e 


lit a set of characters by creating a text file for each. 



I?" 

e^ription: One or more characters can be expanded into their asterisk 
I I representation and saved into a text file(s). The file can 


subsequently be edited with any text editor and then the 
modified character can be reinstalled in the same font or a 


II different font with the replace command. The terminal will be 

prompted for a range of characters to edit (type their decimal 
^ ASCII codes). If more than one character is specified then 

^ text files with names of ‘A<nnn>.edf, where ‘<nnn>’ is the 

decimal ASCII code for the edited character, will be created, 
one file for each character, e.g., ‘afiS.edf. If only one character 
is to be edited the terminal will be prompted for a file name 
for the edit output. 


Example; Cosaand <ona of: l,s,p,«,r,d,a,t,z,a,u,q,7>>f 

Starting charactar <0 to 127>>66»^ 

Ending charactar Cdafault 66>> 66> 

aSS.adf a66.adf these files are constructed on the current disk 

Connand <ona of: l.a,p,a,r,d,B,t,z,a,u,q,7>> 

Notes: • Use this command in conjimction with the replace command to 

edit characters, move characters from one font to another, or 
move characters up and down (in conjunction with the updown 
command). 

• If you accidentaUy enter this command specify a character 
range of 1 through 0 and no characters will be edited. 
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1 — Load Load 


Load a font set for editing or inspection, 

-i I ■III . Il l I II I ■ .. . . . . . .I . ■■■■ 








Description: The terminal will be prompted for a font file name. Th« a 

complete font name, including the ‘.fon’ extension must bQi 
typed. Upon successful loading, font parameters such as top| 
and bottom row, top and bottom blank points, and | 
commentary will be displayed on the terminal (section E,3 
describes these parameters). Any font previously loaded will 
be erased from memory. If the previously loaded font had 
been modified and not saved, then the terminal will be 
prompted for confirmation. 

Ebcample: Coaaand Cons of: 

Font sot filo nmBo> rosnl2. fon> 

aOMAM 2PT. 4/13/84. COPYRIGHT (C> 1984 SOFTCRAFT, INC. 

Top Row"l• Botton rov^O 

Blank Points <top>"*4» blank points <bottos>"0 
Consand (ons of: l,s,p,s,r,d.s»t,c,a,u»q,7>> 

'iotes: • There is slightly more space avsdlabie for loading a font at the 

first load connnand than for subsequent loads; if there is not 
enough room for a font try starting Efont over and load again. 

• If there is not enough memory for the font then nothing will 
be loaded, but the previous font will still be erased. 

• This connnand is different than the load command in Cfont. 
The Cfont command loads mapping files while this command 
loads fonts. 

• If you accidentally enter this command respond to the prompt 
with the file name Tancfont.pro’ (or any other non—font file). 
Efont will notice that the file is not a valid font file and do 
nothing. 
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H 


Margins 


Margins — m 


the margins of a range of characters. 


m 






liption: The left and right margins can be set to different values for a 
range of characters. The terminal will be prompted for a 
range of characters and for new left and right margin values. 
(The ‘box width’ of a character is the horizontal distance 
taken up by the character on a line. It is the ‘ink width’ of 
the character plus the left and right margins. There is 
currently no way to set the overall box width of a set of 
characters to a uniform number other than by individually 
changing the margins of characters according to the ink width 
of the character.) The margins must be numbers in the range 
—120 to 120 (for the Epson MX version or —240 to 240 for 
the Epson FX version). The overall box width of a character 
must be zero or greater. 


lixample: Couand Cona of: ,z»a,u,q,7>>i 

Spacify a ranga of charactara to aat Bargixia for 
Starting charactar CO to 127)>66^ 

Ending charactar Cdafaiilt 65>>66£ change and 

Tha currant marglna for charactar 65 ara 0 (laft) and 2 (right) 

Naw laft margin C-240 to 240»2> increase the margins 

Naw right margin C*240 to 240)>3A 

Command (ona of: l,m,p»a,r,d.m,t,z,a»u,q.7)> 

lotes: • Negative character margins are useful in a variety of situations. 

A character with a negative left margin will ‘back up’ the 
print head before printing the ink for the character. Similarly, 
a negative right margin will cause the print head to back up 
after printing the character. Slanted characters fit best 
together with negative margins because of the ‘overhang’ of 
slanted characters. Even a vertical character such as ‘f has 
right overhang that calls for a negative right margin for best 
fit. Ui^ negative margins also for accent characters that are 
to be overprinted over other letters. In the latter situation 
you should probably have negative margins that result in a 
character with a box width of zero. 


• This command has nothing to do with the margins on the 
printed page (e.g., as set by the Pfont ‘+lm’ and ‘+lw’ 
parameters); it only affects individual characters. 
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A space character is jnst a character with a left and/or right 
margin but no ink. Different sized space characters can be 
made by simply changing .the margins of character codes that 
were previously undefined in the font. 

If you accidentally enter this command specify a character 
range from 1 though 0 to leave the margins unchanged. 
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- Print • Print — p 



:ription: A sequence of one or more characters can be expanded into 
their asterisk representation and printed on the printer. Along 
with each expansion a version of the character will 

also be printed. The termini will be prompted for a range of 
characters to print. Type the decimal ASCII codes of the 
range of characters to be printed. 

mple: Coumd (ons of: l.o.p,o,r»d,B.t,jB,a,u,q.7)>£ 

Starting charmctar (0 to 127>> 66> 

Ending charactar Cdofanlt 66»^ 

a display similar to that of the *d^ command will be printed 
on the printer in addition to a normal printing of the character 
Couand (ona of: l,a,p,a,r.d,B,t•z,a.u,q.7>> 

ie: Also, see the display command. 
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q — Quit 
uit from Efont. 




Quit — 



Description: If any changes have not been made permanent by saving the 

font, then Efont wiU prompt for confirmation. 


Example: 


CoBfeand <ona of: l,s,p,e,r,d.B,t,z.m,u,q.7»q 

Do you want to forgot tho changoo juat aado <y or n>>n 

the font hadnH been saved yet 
Couand (ono of: l,B,p,t,r,d»B,t.z,a,u,q,7>>t 
Output filo naao for font oot>» yfont.fonA 
CoBMand Cono of: l,o,p,o,r,d,B,t,£,aiU.q,7>>q 
A> 
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Replace 


Replace — r 


lice a set of characters with their edit file specifications. 







erlption 




: This is generally used in conjunction with the edit command, 
but can also be used to read in characters or logos created 
from scratch with a text editor. The terminal will be 
prompted for a range of characters to be replaced and the 
replacement file names follow the same convention as do the 
edit command file names. The text file specification of the 
character to be replaced should begin with three integers, left 
margin, right margin, and ytop values, respectively (see section 
E,2 for a detailed discussion of the role of ytop). The rest of 
the file should be asterisks and spaces indicating the dot 
pattern of the new character. The file names of the '.edf files 
found will be printed on the screen as the character is 
replaced. Regardless of the character range given, only those 
characters with corresponding ‘.edf files on the currently 
logged disk will be replaced. Therefore, if you want all ‘.edP; 
files on a disk to be used as replacement files* you can simply 
give the range 0 to 127 instead of giving all of the individual 
characters. 


xample: CoBsand (ona of: l,s,p,a,r,d,B»t,z,a,u,q,7>>r 

Starting charactar (0 to 127>>6^ 

Ending charactar <dafault 60)>66^ 

aS&.adf a66.adf *these were the only files on the disk 

9 

Connand (ona of: lgS,p,a,r,d,B.t»£,a,u,q,7)>r 
Starting charactar (0 to 127>> 44> 

Ending charactar (dafault 44>>A 

Fila nana for raplacanant apac. (dafault a44.adf>> Bvchar.adf> 
Bjchar.adf type a new name to replace with a different file 

COBBand (ona of: lgagp»a,r.d.B,t.z,a,u,qg7>> 

otes: • Look at a file created by the edit command for an example of 

the required file format. 

• See section E.3 for a discussion of the maximum character size. 

• If "WordStar is used to edit these files be sure to use 
non—document mode to ensure creation of a DOS compatible 
file. In general, you should make as plain a file as possible for 
use with this command. 
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# The error message, ‘Invalid character ... it should be an 
asterisk or a space’, will be printed on the screen if a 
character other than an -asterisk or a space is found in the 
replacement file. Some word processors substitute tab 
characters (ASCII code 9) for sequences of spaces; make sure 
to turn this feature off in your word processor when creating 
these replacement files. 

• This command m^y cause the height of the font to change 
(i.e., if a large character is added to a small font). If the 
height does change you should use the auxinfo command to 
reset the blank points values. 


• If you accidentally enter this command specify a character 
range of 1 through 0 and no characters will be replaced. 


o 


5 
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fc'f' 

^ Save ’ Save — s 

if . • 


^ the modified font set. 



crlption: Any replacements or other modifications made to a loaded font 
V. can be made permanent by saving the modified font on disk. 

I The terminal will be prompted for a font file name; type the 

entire name including the ‘.fon* extension. 

mple: Couand (one of: l,s,p,o,r.d,a,t,s,a,u,q,7>>f 

Output filo nuio for font oot> nTfont.fonA 
CoBBind (ono of: l,s,p,o.r,d,n,t,z,a.u,q*7» 

f-- - . • 

e: If you try to overwrite an existing file the terminal will be 

prompted for confirmation. You must give a file name so use 
the name ‘delete.me’ if you do not really want to save the 
font. 
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t — Test 


Test — 


Test the font by printing a string on the printer. 




Command 


Description: After replacements or other changes have been made it 

useful to test the new font. This command prompts for i" 
string to be printed. A carriage return ends the string input* 
The Pfont embedded commands ‘\a’, ‘\u’ and ‘\\’ ar^ 
recognized . 

Example: Couind <one of: l»s,p,o.r,d,B.t,s,m«Urq,7>>t 

String to print> This is > tost otrlny >^ 

the input string will be printed using the currently loaded font 
Couand (ono of: l,s.p,o,r,d»B,t,z»a,u,q.7>> 


Note: 


This command always uses the highest quality mode (i.e,, 
—RD) to print. 
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^Updown • Updown ~ 

a value by which to move characters up or down when editing. 


— u 


u 




iption: The terminal will be prompted for a positive or negative 
integer. A positive integer indicates that characters should be 
moved up (by changing the ytop value) when they are edited 
with the edit command. A negative integer means move them 
down. To move characters up or down and make the changes 
permanent, use the Efont command sequence: 1) updown^ 2) 
edit, 3) replace^ 4) save. 

Couand (ona of: l,B,p,a.r,d,a,t.z,a,ii,q,7>>u 
You can nova a charactar up or down ralativa to Ita 
currant vartlcal position whan charactara ara aditad 
to a fila. 

Mova up (poaitiva) or down Cnag.> how many dots Cdafault 0>> “Bi^ 
Couiand (ona of: l,a.p.a,r,d»n,t,z,a,u,q,7>> 

• This command has no immediate effect on the font, but is 
used in conjunction with the edit command. Its effect is also 
incorporated in the display and print commands. The edit, 
display^ and print commands are the only commands affected 
by updown. 


• The underline location of the \u Pfont command is not 
affected by the updown conmiand. That is, if you move a font 
down by half the height of a character (e.g., to create a 
subscript font) and then try to underline characters from that 
font the ‘underline’ will probably cut through the middle of 
the character. There is no way to. change the underline 
location of the \u command. 

• See section E.3 for a discussion of the maximum and minimum 
allowable vertical locations of characters. 


• A character is moved up or down simply by changing the ytop 
value as the ‘.edf file is created. The same effect can be 
achieved by changing the ytop number in an existing ‘.edf file 
with your word processor. 
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Description: This prompts for a range of characters to be removed from the 

loaded fonts set. The terminal will be prompted for 
confirmation. 


Example: Couiuid <on« of: l,s,p,o,r,d,a,t,z,a,u,q,7)>z 

Specify a range of characters to delete 
Starting character (0 to 127)>0> 

Ending character Cdefault 0)> 31> 

Are you sure you want to delete these (y or n>>y 
Cosnand Cone of: l.s,p,e.r»d,a,t,z.a,u,q,7)> 

Notes: • This command may cause the height of a font to change, for 

example, if all of the characters with descenders are removed 
from a font. If the height of the font does change you should 
use the auxinfo command to reset the top and bottom blank 
points values. 

• If you accidentally enter this command give a character range 
from 0 to 1 and then answer no (type ‘n’) in response to the 
confirmation prompt. 
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0 PRINTING MECHANICS 






> 'A 

i ■/<»£ 

Ca 


e different printers supported by have different print 

pechanisms, each resulting in slightly dm^nt limitations. These 

pfferences will be invisible for the most part but will be of interest to 
users defining new fonts using Efont and to a lesser extent Cfont. The 
discussion below addresses the mechanics of the Epson MX and FX versions 
(remember the FX version works for the RX printer as well) and the 
resulting interline spacing limitations. Other printers can usually be«* 
described with the same words, but with different numbers filled in in 
various sentences. For example, the Epson MX version prints a column of 
dots 8 points high (one point is approximately l/72nd of an inch) in one* 
pass of the print head and requires three passes to fill in such a column 
while the Toshiba Pi360 and the Epson LQ—1500 print a column 9.6 
^ints high and require only one pass. 


Because of the parameters of the Epson print head and the minimum 
allowable paper movement, we find it convenient to define a new term 
I called a ‘print head row’ or just ‘row’. A row contains up to 24 vertical 
dot locations and is 8 points in height (yielding the 3 dots per point, or 
. 216 dots per inch, resolution of the Epson). Therefore, an 8 point 
usually fits into one row. 

This term is used because the height of a ‘print head row’ is usually equal 
to the height of the printer’s print head. However, due to limitations 
imposed by different printers in their graphics printing modes it may 
actually require more than one pass of the print head to print all of the 
dots in the row. For example, the Epson FX version requires six print 
head passes for each row for best quality while the Epson LQ—1500 version 
requires only one. The following diagrams show how dots are placed on 
paper in successive rows. The dots between the horizontal lines are all 
printed in one row with very little paper movement and then the dots 
between the next set of horizontal lines are printed after a paper movement 
equal to the height of the row. The letters ‘A’ and ‘p’ are from the 
Roman 10 point font of the Epson FX version and are the same as those 
used at the beginning of the Efont part of the manual. 
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Pfont ttAderllae location 


he rows are numbered for use with* Pfont. Each row in the Epson MX 
id FX version contains 24 vertical dot ‘positions’ where a position is 
nply a vertical location at which a dot could be printed. The row 
imber for a row is the height of the lowest position in the row divided 
24. For example, if we count down from the baseline of the ‘p’ in the 
ure above (remembering that the baseline for this character is at location 
we see that the lowest dot position is at location 0. (Remember we are 
inting positions not dots printed ; the lowest dot in the ‘p’ is at one 
ile the lowest position in the row where a dot could be printed is at 
o.) Therefore, row zero (dot position ‘0 divided by 24’) contains the 
cender of the ‘p’ and most of the ‘A’ while row one contains the top 
dots of the ‘A’. Pfont uses row numbers on a font—wide basis instead 
on a character by character basis and so if we assume the ‘A’ and the 
are the highest and lowest characters, respectively, for the Roman 10 
it font then this font, as a whole, is completely contained in rows zero 
one. 


consider a font that would be slightly subscript to this font. In this 
font the baselines of the characters are just two dot locations lower 
they were in the normal font. The following diagram shows how the 
md ‘p’ now fit into rows. 













)tice that the ‘p’ character now descends into row number minus one and 
erefore the font as a whole uses dot positions in row one, row zero and 
w minus one. Printing of this font then requires printing of three ‘print 
ad rows’ instead of the two required on the normal font (18 passes 
stead of 12 on an Epson FX). 

order for Pfont to achieve precise spacing between two successive lines of 
int it needs to know two other items of information about a font: two 
lues to indicate the relative position of a font within the top and bottom 
w. These are expressed as the number of ‘units’ of blank space at the 
p of the top row and at the bottom of the bottom row. (The ‘unit’ is 
e vertical spacing unit used in Pfont, i.e, the ‘d’ unit as in ‘\v+ld’. For 
e Epson MX/FX versions the tinit is equal to l/72nd of an inch or three 
t positions. For the Epson LQ—1500 version the unit is l/180th of an 
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ich and for the Toshiba version the unit is l/48th of an inch.) These 
slues are called top blank points and bottom blank points, respectively. 

I - ■ 

I the normal (non-subscript) ‘Ap’ example above the font has a top blank 
jinia value of 6. The faint dots displayed above the ‘A’ and below the 
are there to facilitate counting the empty positions in the row. For the 
there are 20 positions above the topmost dot in the ‘A’ and because 
lere are three dots per vertical spacing unit in this font we arrive at a 
)p blank paints value of 6 (tnmcating ‘20 divided by 3’). The ‘p’ has one 
npty position below its bottommost dot so we get a bottom blank points 
alue of zero. These are values for the font as a whole so we have 
turned that the ‘A’ is the highest character in the font and the ^p’ is the 
west. Similarly, the subscript font has top blank points value of 7 and a 
>ttom blank points value of 7 (22/3 and 23/3). 

.2.1 INTERLINE SPACING LIMITATION 

he top blank points and bottom blank points values are combined in the 
font program to determine the interline gap or the amount of white space 
^tween two lines of text. Consider two consecutive lines of text. Just for 
acussion call the bottom blank points value of the upper line ‘upperbp’ 
u pp er—line—bottom—blank—points). Call the top blank points value of 
e lower line ‘lowertp’. The minimiun interline gap between these two 
es is ‘upperbp+lowertp—7’. For example, consider the subscript ‘Ap’ font 
the previous section. Two consecutive lines of this font would yield a 
perbp’ of 7 and a ‘lowertp’ of 7, so the minimum interline gap would be 
7—7’ or 7 points. That is, it would be impossible to have the bottom 
a ‘p’ on the upper line just touch the top of an ‘A’ on the lower line; 
re would be at least 7 points of space (21 dot positions) regardless of 
value of the ‘+8p’ parameter. (This limitation does not apply to the 
^n FX80 printer and other printers that can back the paper up. With 
se printers Pfont will back up the printer if the requested ‘+sp’ spacing 
less than the minimum interline gap. Note that the formula 
)|>erbp+lowertp—7’ may be different for versions other than the Epson 
</FX.) 

iematively, look at the normal ‘Ap’ font. Here ‘upperbp’ is 6 and 
vertp’ is 0 yielding a minimum spacing of —1 points. That is, the two 
« could theoretically overlap by 1 point. (Although the ‘+sp’ parameter 
: > not allow for negative spacing the ‘\v’ embedded command can specify 
rative spacing and would allow a value of —1, as in ‘\v—Id’, for this 
) 

r two examples point up the practical reason for choosing particular 
r* values (or baseline value in Cfont). A wider range of ‘+8p’ values is 
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sslble when a font fits into the minimum number of rows^ thus 
Inimizing the sum bottom blank points + top blank points. In Cfont, the 
iilidard font baseline of 7 was chosen (for Epson MX/FX versions) so that 
^ descenders of the lower case letters in the 12 point font just fit into 
w zero. As an additional benefit, minimizing the number of rows for a 
It minimizes the disk space required to store the font and also maximizes 
inting speed by reducing the number of passes required to print the font. 

i?" 

|!2 baseline and relative vertical font location 

r 

be manual has stated before that the vertical location of a font has 
lative significance only, and no absolute significance. This section 
cplsdns this point further. First, there are three exceptions to the 
atement. That is, there are three situations where the location does have 
>solute significance: 1) the location for the Pfont underline (‘\u’) 
)inmand is always at zero in the Epson MX/FX versions, 2) characters 
ave to fit within a global coordinate system as described in section E.3, 
ttd 3) there are some printer—specific limitations as described above in 
K:tion E.2.1. Although these are important exceptions the remainder of 
lis section ignores them to simplify the discussion. 

a '• 

his is the key point: Consider a page of text with a line in the middle 
r it printed in the normal ‘Ap’ font described in the last section and then 
insider the same page of text with that line printed in the Hwo—dot 
ibscript’ ‘Ap’ font. The page will print exactly the same in both cases 
ght down to the spacing between the lines measured in l/216th’s of an 
Lch. This says that the vertical location of a font is insignificant unless 
lere is another font printed on the same line. If the line of text under 
>nsideration were printed half in one font and half in another then, of 
)urse, the subscript font would appear slightly lower than the normal font. 

i^hen Pfont determines the amount of space to leave between two lines it 
»oks at the bottommost dot of all of the fonts on one line and the 
)pmost dot of ail of the fonts on the succeeding line and leaves the ‘+sp’ 
nount of space between these two dots. (It does not actually look at the 
laracters printed on a line, but instead looks at the top and bottom row 
sdues and top and bottom blank points values for a font, as a whole, to 
Btermine the topmost and bottommost dots for the fonts on the line.) 
herefore with either the normal ‘Ap’ font or the subscript version there is 
ill the same amount of space between the previous line and the top dot 
i the line containing the ‘Ap’ font. In the case where both versions of 
le font are on the same line there will still be the same amoimt of space 
Btween the previous line and the top dot in the ‘A’ of the normal font 
ut in determining the interline space for the succeeding line Pfont will 
»ok at the bottommost dot in the subscript font because that font is lower 
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v^erall than the normal font. So in this latter case the overall height of 
le text line contsdning the two ‘Ap’ fonts will be greater than either of 
le cases where there was only one font on used on the line, but there will 
e the same amoimt of whitespace between lines. 

; is sometimes useful to fool Pfont by providing false blank points values 
>r a font. For example, a subscript 8 point font that is to be used in 

mjunction with a normal 12 point font works best if it has a bottom blank 

oints value that causes Pfont to think the bottommost dot in the 
ibscript font is at the same location as the bottommost dot in the 12 
oint font. In this way the spacing between two successive lines of 12 

oint text looks the same whether there are subscripts on the line or not. 

you look closely at a line containing subscripts however, you will see 
lat the bottoms of the subscript characters come closer to the tops of the 
icceeding line than would the descenders of the 12 point font. That is, 
le amount of whitespace between the ink of the lines is not uniform but 
le overall spacing between baselines of successive lines is uniform. The 
font auxinfo command allows you to set the blank points values to any 
ositive integer. In the 8 point subscript case we specify a bottom blank 
nnts value of 8 to make Pfont think the bottommost dot of the subscript 
at is at the same location at the bottommost dot of the 12 point font; 
12 point font has a bottom blank points value of zero and a bottom row 
zero while the subscript 8 point font has a bottom row of minus one, 
, in essence, we tell Pfont that the subscript font should be treated as 
yi extending into row minus one at all (the 8 bottom blank points is 
actly equal to the height of a row). Note that this method works best 
L printers that can back the paper up in the printer, such as the Epson 
X80. Otherwise, large blank points values exacerbate the interline spacing 
nitation described in section E.2.1. 

3 MAXIMUM CHARACTER SIZE 

le maximum character size may vary for different printers, but is always 
least one inch by one inch. The maximiun character size for the Epson 
X/FX versions is one inch wide by a little over one inch high. The figure 
low consists of two characters, a large box and a 14 point ‘A’ printed 
4de the box (remember the reduction factor used in preparation of the 
muai). The box is the largest character that can be handled by Efont. 
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119 ,167(MX) 239,167(FX) 

^ A 

0,-72(MX k FX) 


‘he ‘A’ printed inside the box indicates the relative vertical position of the 
aseline of the distributed fonts. The horizontal location of a character is 
etermined by the left and right margin values (not demonstrated in this 
x:ample). The solid tick mark at the left of the box is vertical location 
ero and the dotted mark is location seven, the default baseline. For 
Ipson MX/FX versions the maximum height (i.e., the maximum ytop 
^ue) is 167, the lowest dot is at height —72. For the Epson MX version 
he range of horizontal values is 0 to 119 while for the FX version allows a 
lorizontal range of 0 to 239. Other printers have different values 
lepending upon their graphics mode resolution. The replace command will 
jnore any dots lying outside the box. The generate command in Cfont 
Iso clips characters to fit in the box. See the baseline command in Cfont 
or more information regarding placement of characters inside the verticsd^ 
ange and for an example of the largest character that can be produced 
rom the Hershey character database. 
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C-Creating Fonts 

^lershey character database is a set of characters created by Alan V. 

for the National Bureau of Standards (Wolcott, NBS Special 
i)Ucation No. 424). The entire database is displayed in Appendix 6. The 
int 'program allows the user to choose characters from the Hershey 
ibase and map them to ASCII character codes ther^y constructing a 
I" set for use with the rest of the programs (Pfont and Efont). 

[Indicated in previous parts of the manual, a font set contains up to 128 
factors, and usually will contmn at least the 95 printing ASCII 
ffacters. 

i^parate tutorial is available for an in—depth introduction to Cfont. 
re we provide one simple scenario to illustrate the use of Cfont. 
ppose you want to create a font containing only one character chosen 
m the Hershey database, say a bell character. Hershey character number 
) is a nice bell. Start up Cfont and use the interactive mapping 
nmand by typing ‘m’. Cfont asks for the ^Starting number of font set 
(uence’. This requests the ASCII code of the character to which the bell 
)uld be mapped. In this example, we will map it to ‘B’ for bell and 
jrefore type ‘66’ as the ASCII code for ‘B’ (appendix 8 gives the ASCII 
les for all characters). Next Cfont asks for the ‘Start of matching 
rshey sequence’. Here we type ‘380’ to identify the bell character. Next 
mt asks for the ‘End of sequence (Hershey number)’. Here we type 
um (,^) to accept the default (380) because only one character is to* be 

lerated for the font set. (We could type a number greater than 380 and 

m Hershey character 381 would be mapped to ‘C’, 382 to ‘D’ and so 
.) Executing the generate command by typing ‘g’ will cause the bell 
wacter to be constructed and associated with character ‘B’ and ’ then 
mt will ask for the name of an output font file, call it ‘bell.fon’. The 
it file thus created can be used with Pfont to print the bell character in 
j middle of any other type of text. That is, if the Pfont command line 

bnt text.ff 4-fo romnl2 bell’ is executed and the file ‘text.fP contsdns 

ae \flB\fD rang’, it will print as ‘The rang’. A transcript of such a 
sion is shown below. User input is underlined and corresponds to a 
of the RETURN (or ENTER) key on the keyboard. 
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cfonti> 

Cfont: Create Fonts, Version n.na (Epson FX> 

Copjright (C> 1984 SoftCraft, Inc. 

CoMiand (one of: ■•ltg«s»d,p.f.b,s,q,7>>i use the map command 

Starting nnnber of font set sequence (default 68)>66^ map to the ‘B* key 

Start of natcliing Hershej sequence (0 to 1593» 380A choose the hell symbol 
WnA of sequence (Hershej nunber) (default 380)>A map only one character 

Couand (one of: n,l,g,z,d,p,f•b,s,q,7»g generate the font 

There are. 1 characters specified in the font set. 


a 

Font set (output) file naae> bell.foni^ 
low sorting the font file. 

• 

bell.fon written 

top row*l, bot row»0, top blank*2, bot blank^O 
The calculated font size is 14 points 
Connand (one of: B,l,g,z.d,p,f•b,s,q,7)>q 
A>pfont text.ff ^fo ronnl2 bell>^ 


name the font ^belljon^ 


exit Cfont 


^ suggest that you print out a copy of the Hershey database on your 
liter. The copy appearing in the Appendix has been photographically 
uced and may have been printed on a printer other than the one you 
using. The following transcript shows how to print out a version that 
' aid you in constructing fonts from the database. Line up the paper in 
r printer with the perforation about haif an inch above the print head 
>re printing. 

CoBBsnd (ons of: ■•l,g,z,d,p,f•b,s.q,7)>p 
Xot snough Btaory to print st that scsls factor 
Sons charmctsrs nay bs clippsd 
Starting char actor (dofault 0) > 0ii 
Ending charactor (dofault 0) >169^ 

Couand (ono of: ■•l.g,z,d,p,f,b,s,q,7)> 

r Cfont commands are the scale factor command, which allows the 
ley characters to be reduced or enlarged, the save mapping command, 
t allows interactively specified mappings to be saved on a file and 
equently loaded with the load mapping command, and the print 
mand, which prints Hershey characters on the printer at the current 
^ factor for a preview of what the characters wUl look like when the 
set is generated. The print command was used to print appendix 6. 
e of the characters are truncated in Appendix 6 so that they fit on the 
but they can be created in full when generating a font with the 
*ate co mm and. All of the commands are described in detail below, 
■i summary of the commands appears in the final appendix. 
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I,. 

" COMMANDS 

. • • 

■ 

It 

9 Cfont command interface is exactly the same as that of Efont. All 
imand names are single letters and do not need to be followed by a 
riage return. Immediately upon typing of the command letter the 
gram will prompt the terminaJ for any required parameters. The list of 
liable commands can be obtained by typing a question mark in response 
the ‘Command’ prompt. Note, however, that question mark generally 
» pot provide help when parameters are being requested by the program 
1 the standard CP/M line editing characters are in effect. The 
rimand descriptions follow. 

short summary of the commands appears below ordered by function, 
e following pages contain detailed descriptions of the commands in 
habetical order. 


Map 

Save 

Load 

Zap 

Generate 

Factors 

Baseline 

Print 

Display 


Enter mappings from keyboard keys to Hershey characters. 
Save the current mappings to a file for later reuse. 

Load a previously saved set of mappings from a file. 
Remove some of the current mappings. 

Generate a font with the current mappings. 

Set the scale factors for enlargement/reduction. 

Set the baseline of the characters to be generated. 

Print a range of Hershey characters on the printer. 

Display the current mappings, scale factors and baseline. 
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Baseline 


3et the baseline of the characters to be generated. 

I » 1 1 n I 'n T fi ww ' i i i i i i i n m n i . i ' f M b •. ’ . ’' v ' Tvy. -*.V,'.* ?T * A vTv. 

T.'.'/y* • ^ . i , i - .4 .i..- .. ! i.».j.ii.n, »t.. >.» 

■:;S;(Si(iiiiiiiii _^_‘ b 


Baseline — w 



Description: Any two fonts printed on the same line miist have been ! 

created with the same baseline if the baselines of thn 
characters are supposed to line up. The default baseline 1| 

normally 7, but can be modified to more efficiently store | 
particular font, to create a subscript or superscript font or to 
generate a specialized, very large font. For example, you could 
create a very large font (about 120 points) if it consisted of 
only upper case letters. After reading section E.3 you would 
see that a baseline of ^72 might allow creation of such a font 
on the Epson FX printer. A 120 point ‘G’ (Hershey character 
95) appears below in the maximum character box (see E.3). 
This was created with baseline —72, xl=12, x2=l, yl=34, 

y2=3 (remember the photographic reduction used in 

I preparation of this manual). 



The ‘G’ is actually 80 points high, but the size of a font 
measures from the bottom of the descenders to the top of 
upper case characters, so the *G’ would be considered to be a 
member of a 120 point font. 


ample: Coumd (one of: •b,0,q,7)>b 


basoli&o (default 7) >-20> 

Couand (ona of: B.l^giZ.d.p.f.b.a.q,?) 


lower the baseline by 27 dots 


• If you accidentally enter the baseline command just type return 
in response to the prompt to leave the baseline value 
tmchanged. 

• There are only four known reasons for changing the baseline of 
a font to be generated: 

1) to create a superscript or subscript font based at a location 
higher or lower than other fonts (change the baseline by a 
little, more than the number of dots in an ‘x’), 

2) to create very large characters such that the baseline has to 
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be adjusted so the resultijig characters fit into the maximum 
character size box (section E.3), 

3) to optimize character placement within ‘print head rows’ 
(section E.2.1), and 

4) since the location of the Pfont underline command (‘\u’) is 
fixed you can get the effect of changing the underline location 
by raising or lowering a font instead. 

Section E.2.2 gives more detml on the effect of different 
baseline. 
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d — Display 

Display the current mappings, scale factors and baseline. 


Display 







Description: The current mappings showing ASCII code, keyboard key an( 

Hershey number will be displayed on the terminal. Th|j 
terminal will ‘freeze’ when the screen is full; type any key 
display the next screenfull. 


Example: 


Couiand <on« of: ■,l,g.£,d»p.f.b,s,q,7»d 
f ontsot: Horshoy 

66(A>:0 the *A* key is mapped to Hershey character 0 

66(B>:1 the key is mapped to Hershey character i 

Thoro are 2 ch&ractors currontly sptcifiod 

xl»l, x2»l, yl"l, y2«l, basolino*? the current scale facion 

Cowiand <ona of: a,l,g•z.d.p.f,b,a,q,7» 
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^tors 


Factors — f 


^feale factors. 




... . 

A'1-A 


^^Pption: The characters in Appendix 6 can be scaled up or down 

(reduced or enlarged) by setting the scale factors. As 
characters are constructed by the generate conunand and the 
print command the horizont^ and vertical components of the 
character are multiplied by a scale factor. Because floating 
point numbers (e.g., 1.5) are not available in Cfont we use a 
fraction (e.g., 3/2) as the scale factor. For the horizontal 
direction we use the fraction xl/x2 where xl and x2 are 
integers that can be set using the factors command Similarly^ 
& the vertical components are multiplied by a fraction yl/y2. 

♦^4" This command allows the user to set each of the values xl, 

x2, yl, and y2. 

-rV: 

^ample: Couand (ona of: ,b,s»q,7>>f 

Tha charmctara will ba acalad by tba fractions xl/3c2 and yl/y2 
in tha x and y diractiona. Nomally tha y scaling should ba about 
tha Sana as tha x scaling. 

xl (dafault 2> >3A change the x scale factor to S/1 

x2 (dafault 1) >A 

yl (dafault 2> >3A same for the y scale factor 

y2 (dafault 1> >£ 

Cossand (ona of: B,l,g»z,d,p.f•b,s,q.7>> 

< 

Notes: • In the Epson MX version the vertical scale factor, should 

normally be about twice as large as the horizontal scale factor. 




• The initial scale factors vary for different printers. The Epson 
MX has about twice the resolution (dots/inch) in the vertical 
direction as the horizontal direction and therefore the initial Y 
scale factor (yl/y2) is 2 while the X factor (xl/x2) is 1. The 
FX version has initial factors of 2 in both directions. 


• The maximum size of a character is one inch wide by a little 
over one inch high and the character should fall in the box 
described in section E.3 or else the character will be clipped. 
See the example in the baseline command description. 

• Characters can be mirrored by setting xl and/or yl to 
negative values. 
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• Not all of the distributed fonts were derived from the Hera^ 
database and therefore we cannot provide scale factors 
would allow you to create matching fonts from the database,^ 

• If you accidentally enter this command simply type return y 

at each prompt to leave the values imchanged. 1 
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fenerate 


Generate — g 


lie the font. 






y i..-■‘i- 


^■'>2 > -,C ‘ 
; 

1 - 


[ption: After the mappings between ASCII codes and Hershey numbers 
have been specked the font can be generated. Font 

generation can take several minutes for standard—sized fonts. 
Cfont will look for the file ‘Hershey.chr’ on the logged drive 
| : and, failing that, on drive A. If it isn’t found then the 

terminal will be prompted for the proper ‘Hershey.chr’ file 
name. A temporary font file is constructed on the logged disk 
so there must be enough disk space on the logged disk to 
accommodate two font—sized files (approximately lOK for a 12 
point, 96 character Epson MX font or 20K for the same Epson 
FX font). A period is displayed on the terminal for each 
character as it is constructed during font generation. After all 
of the characters are constructed from the Hershey database 
the terminal will be prompted for the name of the (final) font 
file. Do not remove the disk in the logged drive at this poliit 
as it still contains the temporary font file. 


bcample: 


otes: 


Couand (on« of: ■•l,g,z,d,p.f•b.s,q,7>>g 
Thoro aro 12 charactara apacifiad in tha font aat. 

. one dot for each character 

Font aat (output) fila naaa> aYfont.fonA 
How aorting tha font fila. 

.. one dot for each non-avaee character 

B]rfont.fon writtan 

top row*li bot row*0, top blank«2, bot blank*0 
Tha calculatad font aiza la 14 polnta 
Coanand (ona of: a.l.g.z.d.p.f•b,a,q,7)> 

• You can request that the final font be constructed on a 
different drive by including a disk specifier in the font name 
(e.g., b:myfont.fon). 


• Osborne note: The ‘Hershey.chr’ database is larger than the 
cap 2 u:ity of a single disk, so the file has been split into two 
parts, ‘Hershey.chr’ and ‘Hersheyl.chr’. When ‘Hersheyl.chr’ is 
on drive A or the logged drive then the continuation should 
happen automatically. If ‘Hersheyl.chr’ cannot be found Cfont 
wiU prompt for a file name. At this point a new disk 
containing ‘Hersheyl.chr^ can be inserted in the nonlogged 
drive (the logged disk still contains the temporary font file so 
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do not remove that disk). 

\ 

t 
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Load — 1 


f set of map pings from a file. 

‘ ‘^ ■‘■ »* **** ■ * * ***’ * . it>*, ! »** i„ *hAi<■ 


1 


iption: A mapping specified with the map command can be saved to a 
file with the save command and subsequently loaded with the 
load command. 


< Ml 



> - Ak 


r-'sfi 




Couand (ona of: ■•l,g,z,d,p»f•b,s,q.7)>l 
Filo for aapplng sptciflcation> b;»yfont. 

Couiaiid <ono of: ■•l,g,z.d,p,f•b,s,q,7>> 

• If necessary, the zap and map commands can be used after the 
load command to override some of the loaded mappings. 
Multiple load commands are also permitted to merge mappings 
from a variety of saved mapping files. 

• This command loads mapping files, not font files. You should 
use Efont, not Cfont, to load and modify an already created 
font file. 




• A map file for an Old English font is displayed in section C.2. 
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m — Map 


Map —^ 




Map keyboard key s to Hershey characters. 


ii 







m 


■ '"tl 


■ta 


Description: Enter mappings from the terminal to specify tho 

correspondence between the ASCII codes in the font to 
generated and the characters in the Hershey database. Each 
font generated by Cfont can contain up to 128 characters 
corresponding to the ASCII codes 0 through 127. The map 
command allows a correspondence to be made between these 
ASCII codes and the characters in the Hershey database. 

The introduction to Part C gives a short example using the 
mapping command. After the ‘m’ is typed the program will 
prompt for the ‘Starting number of font set sequence’, asking 
for an ASCII number in the font set to be generated. Next 
Cfont asks for the ‘Start of the matching Hershey sequence.* 
This specifies a character number in the Hershey database (the 
database is listed In Appendix 6). Finally, Cfont asks for the 
‘End of sequence (Hprshey number).’ Another Hershey 
character number is requested to indicate the sequence of 
characters to be mapped. The first Hershey character will be 
stored in the generated font as the ASCII code entered, and if 
the second Hershey number entered was greater than the first, 
then the next Hershey character stored as the following ASCII 
code, and so on. 


For example, to create a font with the upper case Old English 
letters mapped to the normal ASCII codes, use the mapping 
command with the following three inputs: (starting ASCII) 65, 
(starting Hershey). 1457, (ending Hershey) 1482. The mapping 
command can be used many times to specify multiple 
noncontiguous Hershey sequences. 

^cample: Couiand Cons of; ,b.s.q,7>>i 

Starting nunbor of font sot ooqaonco Cdtfault 66)> 66;^ 

Start of natcbing Harahay aaquanca CO to 1603)> 1467^ 

End of aaquanca CHarahay nunbar) Cdafault 380)> 1482A 
Coaaand Cona of: B»l,g,z,d.p»f.b,a,q,7)> 

»tes: • Once the mappings are complete they can be saved on disk 

with the save command. 


• Other commands useful during the mapping phase are the zap 
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command which removes* mappings, and the display command 
which shows the currently specified mappings. 

• The default for the mapped—to (ASCII) number is one greater 
than the last character mapped to, dr 65 if no characters have 
yet been mapped. 

• See the print command for information on space characters in 
the Hershey database. 

• If you accidentally enter this command give a Hershey 
character range from 1 to 0 to avoid adding any mappings. 





o 
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p — Print 


Print p 



Print a range of Hershey characters on the printer. 








Description: The terminal is prompted for a range of Hershey characters 

and then these characters are printed on the printer using final 
draft mode and the current scale factors. Appendix 6 was 
printed using this, command with all Cfont default values. See 
the generate command for a description of the alternative disk 
arrangements for ‘Hershey.chr’. Some of the characters In 
Appendix 6 are space characters, e.g., 50, 51, and 52. Usually 
the highest numbered character in a short sequence like this is 
the widest space character and the smallest numbered is the 
narrowest. The margins command in Efont is generally a more 
convenient way to precisely specify space characters than trying 
to identify the appropriate space characters in the Hershey 
database. 


Ebcample: 


N'otes: 


CoBBand (ona of: B,l,g,z,d.p,f•b,a,q,7>>2 
Not anongh BOBory to print at that seal a factor 
SoBO charactara pay ba clippad 
Starting charactar Cdafault 0) > 380A 

Ending charactar (dafault 380> > 4B0A 

characters will print on the printer 
CoBBand (ona of: B,l,g,£.d.p,f »b,a,q,7)> 

• Depending upon the current scale factors and baseline, 
characters may be clipped at the top or the bottom when they 
are printed. This is to allow printing of a useful number of 
characters on a page. The characters will not be clipped when 
they are generated as long as they are contained in within the 
maximum character box (see section E.3 and the baseline 
command). 


• If you accidentally enter this command give a character range 
from 1 to 0 to avoid printing any characters. 













IlK^ription: This immediately exits Cfont. 

Sample: CobbazuI (on« of: •b,o.q,7>>£ 




Cfont does not keep track of whether changes made in the 
mapping information have been saved to file so be sure to save 
the mapping information before exiting Cfont if you think you 
will need the mapping again. 
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Save Save — s 



K^ription: Save the current mappings to a file so that they can be loaded 
with the load command. The terminal will be prompted for a 
file name and the file thus created is a normal ASCII file and 
can be edited with a text editor if desired. 

unple: Coaamnd <on« of: 

Mapping output fila naaa> nYfont.nap> 

■yfont.nap alraadj axiata. Do you want to ovarvrita it (y or n>>x 
Coanand (ona of: ■•ltg,a,diPif,b,a,q,7)> 

es: • This command is for saving a ma pping file; it does not create 

a font file. The file name used here should be different than 

4 

the one used in the generate command. We recommend using 
the file name extension ‘.map’ as in ‘myfont.map’ for map file 
names. 

• A map file for an Old English font is displayed in section C.2. 
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— Zap V Zap — z 


inove some of the current, previonsly specified mappings 



z 

• • • • • *.•• • • '.• •• 





scription: The terminal will be prompted for a range of 
ASCII—to—Hershey mappings to be removed. 


:ample: Coanand (ona of: a,l.g,z,d,p,f•b»a,q,7)>z 

Start charactar of aappinga to ba dalatad (0 to 127>> 33A 
Ending charactar (dafault 0)> 44> 

Coaaand (ona of; a,l,g,z,d,p,f•b,a,q,7)> 

^tes: • This command does not prompt for confirmation, but 

immediately removes the mappings. 

• If you accidentally enter this command give a character range 
from 1 to 0 to avoid deleting any mapping information. 
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12 BATCH MODE OPERATION ! 

Jfont can be executed from a single command line for use within a batch 
le (or CP/M submit file). This mode can be used to create several fonts ' 
t one time without having to wait at the terminal to answer the various 
Jfbnt prompts. This mode of operation requires the use of a previously ^ 
reated map file. To use Cfont in this manner type the command line 

Cfont <fontlil®> <Mpfll«> <xl> <x2> <yl> <j2> <bms«line> <coMi«nts> 

^here <fontfile> is the desired output font file name, <mapfile> is the 
ame of the mapping file for the font, <xl>, etc. are the scale factors, 
:baseline> is the baseline and <comments> is any descriptive commentary 
)r the font. <c6mments> may contain spaces and should not be 
tirrounded by double quotes. 

he following transcript uses the ‘olde.map’ file distributed with Cfont to 
reate a 20 point Old English font. The map file is also displayed below. 

A> cfont old»20.fon oldt.aap 21217 Old English. 20pt. 6/6/84> 

Cfont: Cromto Fonts, vtrsion n.nn (Epson FX> 

Copyright (C> 1084 SoftCraft, Inc.* 

Thsrs art 08 charactsrs spsclfisd in ths font sat. 

Bars to skip ovsr 324 charactsrs in ths Hsrshsy fils so 
it say taks a whils until ths first dot appsars on ths scrssn. 


How sorting ths font fils. 


oldsOO.fon writtsn (Old English. 20pt. 6/18/84) 
top row*2. hot row*"!, top blank"6. hot blank*6 
Ths calculatsd font sizs is 20 points 
A> 

le file ‘olde.map’ contains the following mappings. The mapping numbers 
pear in pairs or triples separated by commas. The first number is the 
'CII number and the second is the Hershey number to which the ASCII 
mapped. If the second number is followed by a colon then the number 
lowing the colon is the end of the Hershey mapping range following the 
ne convention as the mapping command. 

24 1610 . 30 009. 31 1636. 32 1610. 33 1626. 34 1640. 36 642. 36 641. 

37 638 . 38 1630 , 39 1620 . 40 689:690 , 42 1636 , 43 1637 . 44 1623. 

46 1636, 46 1622, 47 688, 48 1612:1521, 68 1624:1625, 60 888, 

61 1638, 62 889, 63 1627, 64 920, 66 1467:1482, 01 691, 92 324, 
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03 602. 04 804. 08 878. 06 1628. 07 1483:1608. 123 603. 124 607. 
126 604. 126 803 ^ 


'0U can easily make 10, 20 and 30 point fonts in Old English and Script 
y ^ Cfont in the batch mode using the batch file (or CP/M submit 
le) supplied on the Cfont distribution disk. Follow these directions. 




i Copy the contents of the Cfont disk to a fresh system disk (i.e., on 
I mSDOS the file COMMAND.COM should be on the disk and in CP/M 
the CP/M operating system should be on the disk’s system tracks) and 
place the new disk in drive A. 


) Log to a drive contsdning at least 170k of free space, 
j Type 

a:mkfonts (on MSDOS), or 
a:supsub mkfonts (on CP/M) 


)ptions: 

l) If you have a hard disk copy the contents of the Cfont disk to a 
directory, log to that directory, type ‘mkfonts’ (on MSDOS) or ‘supsub 
mkfonts’ (on CP/M). 

() ff you have an electronic memory with between 170k and 270k of free 
space log to that drive in step 2. 

5) If you have an electronic memory with 270k of free space insert the 
following step between steps 2 and 3 above. 

2.5) copy a:hershey.chr (on MSDOS), or 

pip m;=a:hershey.chr (on CP/M, where ‘m’ is the electronic 

disk drive) 







^ Appendix 1 — Glossary 

eender —^ The stroke of any lowercase letter which extends above the 
I) of an Xj e «^*9 bj h* 

g 0 |{iie — Xhe location of the bottoms of most letters, e.g. A, x. Some 
uracters descend below the baseline, e.g., g, p. 

^/M — A popular operating system for microcomputers. The full, but 
^er used name is Control Program/Microcomputer. 

ifotilt — The initial, pre—defined setting for a command or parameter, 
is is the setting that will take effect unless the user expUcitly indicates a 
Klified setting. 

scender-The stroke of any lowercase letter which extends below the 

ttom of the baseline, e.g., g, p. 

)S — ^Disk Operating System’, a common name for the operating 
sterns used by the IBM Personal Computer and its compatibles, 
netimes called PCDOS. 

it — An element of the dot pattern that creates the type image of a 
uracter. Also, often used in this manual as a unit of horizontal measure 
lal to 1/120^^ inch. 

ce — Face typically refers to the boldness of a font, l.e., boldface type. 
3 use face to differentiate between regular, bold, and italic forms of a 
en font style. 

I — To place as many words on a line as possible by drawing words 
m subsequent lines until the end of a paragraph is reached. 

lah left (or right) — Type set to line up at the left (or right) margin. 

at — The complete assortment of type of one size, face, and 
entation. 

nnat — The size, style, margins, printing requirements, etc. of a 
nted document. 

Irllne — The thinnest part of a letter. 

rshey database — — The Hershey character database is a set of characters 
ated by Alan V. Hershey for the National Bureau of Stand^ds. The 
)nt program Uses this database to construct new fonts. 
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orlscmtal Measure — A term used by Pfont to indicate a horizontal 
stance. A horizontal measure must include a ‘real’ number and a unit. 
)r example, ‘1.26i’ to indicate 11/4 inches. 

ille — Normally, a style of type with letters slanting to the right, 
^ttemed on a compact manuscript hand. Used in this manual to 
ferentiate any right—slanting font from its related vertical font. 

Miitf — To space out lines by increasing the size of the spaces to make 
e right ends of the lines flush right. 

amlng — To adjust the spacing between two characters to account for 
parent spacing anomalies created by speciflc character adjacency 

mbinations. For example, ‘ox’ looks more widely spaced than ‘oo’ even 
ough the character margins are the same. 

tterspacliig — To place additional space between each letter of a word 
better balance a line or emphasize a word. Pfont does not do 

;terspacing (look at a newspaper, it usually looks terrible). 

^gged disk — Many microcomputers have more than one disk drive, 
le notion of ‘logged disk’ is used to indicate on which drive to search for 
The currently logged disk is displayed as part of the prompt, e.g., 
>’ indicates that drive ‘A’ is the logged disk. 

iDOS — A popular operating system for 16—bit computer systems, 
is is a generic version of the IBM DOS (PCDOS) operating system. 

eratlng System — The flrst (lowest) level of software used with a 

nputer system. This allows the user to use the basic functions of the 

nputer, and most importantly, to use other software (such as 
pular microcomputer operating systems are CP/M and DOS. 

tM — Unit of measurement equal to 1/6'*" inch. 


^— Picture element or dot. 

^int — Unit of measurement approximately equal to 1/72"^* inch, 
dually used for vertical measurement. 

f man — Letters with thick and thin strokes and serifs. 

rda — To change the size of an image by reducing or enlarging. 
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os Serif — Letters without serife and usually having strokes of 
parently even thickness. 

rif — A smaller line used to finish off the main stroke of a letter, 
ually at the top or bottom of the stroke. 

em — The vertical stroke of a letter. 

yle -— Fonts come in different styles, for example Roman, which has 
rife, and Sans Serif, which does not. Other styles appearing in the 
anual are Old EngUsh and Script. 

ibscript, supersci^t —- These are fonts that are higher or lower than 
trmal fonts. In order to do super or subscripts simply switch into one of 
ese special fonts (e.g., ‘romn8p.fon’ for superscripts or ‘romn8b.fon’ for 
bscripts). 

ertkal Muunire — A term used by Pfont to indicate a vertical distance, 
vertical measure must include a ‘real’ number and a unit. For example, 
.251’ to indicate 1 1/4 Inches. 

^ord wrap — To move words fi'om the current line to the next One 
ben the current line becomes too long to be fully printed. 

-hd^t-The height of lowercase letters without ascenders, or 

iscenders. 




— Notes 






Appendix 2 —^ Font Descriptions and Samples 
'ont files gener^ly adhere to the following naming convention. 

<fbntname> .fon 

?he ‘fon’ extension is assumed by Pfont if no extension is given to the 
rguments to the ‘+fo’ parameter. For example, ‘+fo ronml2’ is equivalent 
0 ‘+fo ronml2.fon’. <fontname> can be further refined to the following 
orm: 


<style> { <face> } <size> { <option> } 

^here {<...>} indicates an optional element. <style> examples are ‘romn’, 
Jans’, ‘olde’, and ‘scrp’ for Roman, Sans Serif, Old English, and Script 
espectively. <face> is optional and can be ‘i’ or ‘b’ for italic and bold. 
We are a little loose about the term italic. We use it to modify the 
toman style, which is not strictly accurate but is in common usage. 
Vorse, we use it to describe ‘slanted’ Sans Serif fonts. These are 
haracters that are just slanted Sans Serif characters, but do not have the 
lormai italic script—like curves.) <size> is the size of the font in printers 
K)ints (generally the distance from the bottom of the lower case descendats 
o the top of the upper case letters, but sometimes adjusted for prop^ 
iverall appearance). <option>, if present, is a single letter indicating a 
ont modification such as ‘b’ for subscript fonts, ‘p’ for superscript fonts 
nd ‘f for fixed width (monospaced) fonts. 

rhe standard distribution package contains the most popular fonts and 
Qany more are available from the library of fonts. The standard 

package contains the following fonts: 

romnl2.fon Roman (serif) 12 point font. 
romnil2.fon Roman Italic 12 point. 

ronmbl2.fon Roman Bold 12 point. 

romnl2f.fon Fixed width (monospace) 12 point. 
romnSb.fon Subscript Roman 8 point. 

romnSp.fon Superscript Roman 8 point. 

romnl8.fon Roman 18 point. 

romn24.fon Roman 24 point. 

specl20.fon Special characters; shading, copyright, etc. 

rhe ‘mkfonts’ batch (or submit) file will create fonts in a variety of sizes 
11 the Old English and Script styles. 

rhe following pages show samples of the distributed fonts. Other font 
tyles can be created using Cfont and the Hershey database or obtained 
rom the library. 
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unples of the distributed fonts follow. 


— Roman regular — 

The quick brown fox jumps over the lazy dog. 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

abcdefghijklmnopqrstuvwxyz 

12346e789OI"#$%&’()_=~|-^\{}0+*;:<>?,./ 

— Roman italic — 

The quick brown fox jumpe over the lazy dog, 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijMmnopqrstuvwxyz 
lSS4567890r#S%&>()_= ^\{}[}+*;:<> ?,./ 

— Roman bold — 

The quick brown fox Jumps over the lasy dog. 
ABCDEFGHDSLMNOPQRSTUYWXYZ 
abcdc^(hiJkhnnopqprstuvwxys 
13 » 456 T 890 P#f%&’()_=''l-*\{}{)+*;:<>T,./ 


— Roman fixed width — 

Til* <iaick brown fox Junpo ovor tho luy dog. 

ABCDETOHI JXLMtOPQBSTUVWXYZ 

nbcdofghijklenopqrstuTwxyx 

13348678001*«m* 0_-' I-“\0□ +•; :<>?../ 


— Script — 

jm3)83^KSfX£JIUf()3>25(Jm}WXy3 

12345m90r§$^()-=r^'^*;:^?y 


— Old English — 

(n^r quirk broum fox jumps owrr % lazy log. 

abrbrfgl^kbnnopqrsluuuixyz 

I25l56789Dr'#|x&'()-=M--\»t^^<>?./ 
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Many different sizes of various foists are available from the font library 
The Roman fonts are typically avmlable in sizes from 6 points to 24 points 


Tb« 4«ick br*WM f*x i»mpa tb« iMjr 

Th« quick brows fox Jump* orof the laiy dof. 

The quick brown fox jumps over the luy dof^. 

The quick brown fox jumpe over the lazy dog. 

The quick brown fox jumps over the lazy dog. 

The quick brown fox jumps over the lazy dog. 

i 

The quick brown fox jumps over the lazy dog. 

The quick brown fox jumps over the lazy dog. 

The quick brown fox jumps oyer the lazy dog. 
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following two pages the mapping between printed characters and the 
you type on your keyboard to print that character. The control 
^acters (the ‘control—X’ key is shown here as ‘"X’) can be entered using 
Pfont ‘\a’ embedded command if your word processor does not allow 
to enter control characters into your text file. The program that 
iuced these pages is called ‘dispfont’ and is av^able from the 
iry. The font ‘specl20.fon’ contains characters used for shading and are 
>ped to keyboard keys as shown below. The following page shows the 
•pings for all of the Roman fonts and most of the other fonts available 
1 the Dbrary. 


- F=-OlNJ 

Special chars, 20pt; 9/30/82 
Top rois2 Bottoi row*-! 

Blank points (top):? Blank points (bottoR)=2 
Page 1 


ii (Key) 


Ascii (Key) 


Ascii (Key) 


Ascii (Key) 


( ) = 


065 (A) 


066 (B) 


071 (G) = 


(R) = A 


098 <b> » 


103 (g) 


104 <h) 
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Ascii (Key) 


Ascii (Key) 


, Ascii (Key) 


Ascii 

(Key) 



4 

<'"X) = 


030 

II 

< 

< 

T 

031 

(^_> = 

•— 

032 

( ) 

= 


3 

( f ) = 

f 

• 

034 

(•') s 

If 

035 

(#) = 

# 

036 

(«) 

s 

$ 

7 

(7.) = 

% 

038 

<&) = 

il 

039 

< ' ) = 

» 

040 

( () 

BS 

( 

1 

()) = 

) 

042 

(*) = 

* 

043 

( + ) = 

+ 

044 

(,) 

= 


^5 

(-> = 

— 

046 

(. > = 

• 

047 

</) = 

/ 

048 

(0) 

= 

0 

(9 

<1) = 

1 

050 

<2) = 

2 

051 

<3) = 

3 

052 

<4) 

= 

4 

>3 

(5) = 

5 

054 

(6) * 

6 

055 

(7) = 

7 

056 

<8) 


8 

>7 

(9) = 

9 

058 

(: ) = 

• 

• 

059 

(; ) = 

• 

1 

060 

(<> 

=■ 

< 

>1 

< = ) = 

— 

062 

(>) = 

> 

063 

(?) = 

? 

064 

(e) 

= 

@ 

is 

(A) = 

A 

066 

(B) = 

B 

067 

(C) = 

C 

068 

<D) 

as 

D 


(E) == 

E 

070 

(F) = 

F 

071 

(G) *= 

G 

072 

(H) 

= 

H 

^3 

(I) = 

I 

074 

(J) = 

J 

075 

(K) = 

K 

076 

(L) 

a: 

L 

n 

(M) = 

M 

078 

(N) = 

N 

079 

(0) = 

O 

080 

<P) 

.■= 

P 

n 

(Q) = 

Q 

082 

<R) = 

R 

083 

(S) = 

S 

084 

<T) 

sr 

T 

35 

<U) = 

U 

086 

<V) = 

V 

087 

<W) = 

w 

088 

<X) 

x: 

X 

39 

<Y) = 

Y 

090 

(Z) = 

Z 

091 

<C) = 

[ 

092 

(\) 

= 

\ 

?3 

(3) = 

1 

094 

('') = 

A 

095 

<_) == 

— 

096 

( • ) 

= 


?7 

(a) = 

a 

098 

<b) = 

b 

099 

<c) = 

C 

100 

(d) 


d 

)1 

(e) = 

e 

102 

(f) = 

f 

103 

<q) 

g 

104 

(h) 

= 

h 

)5 

<i) = 

• 

1 

106 

(j) = 

• 

J 

107 

<k) ' = 

k 

108 

(1 ) 


1 

)9 

<m) = 

m 

110 

<n) = 

n 

111 

<o) = 

o 

112 

(p) 

= 

P 

L3 

<q) = 

q 

114 

<r) = 

r 

115 

(s) = 

s 

116 

(t> 

= 

t 

17 

(u) - 

u 

1 18 

(v) - 

V 

119 

(w) = 

w 

120 

(X ) 


X 

21 

(V) = 

y 

122 

<z) = 

z 

123 

(C) = 

{ 

124 

( J ) 


1 


i ; i . 

\ 

1 

( -) - 
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ftxU will print any standard ASCII file regardless of how it was 
oduced. However, if your word processing software maintains its own 
Ing system or inciudes its own special character codes in files, then it will 
i work properly with 9an^ 9»nL Most word processing software, as well 
data base management systems and spreadsheet programs produce 
mdard ASCH files and thus work well with 9€m^ 9tU. In some cases, 
ecial export commands are avidlable to turn a non-standard word 
ocessing file into a standard ASCU file — consult your word processing 
mual. 

has been designed to accommodate word processors that ‘turn on’ 
e ‘high order bit’ of cmtain characters. Thus, the export procedure 
mtioned above is not necessary for WordStar or similar word processors. 

irrently availabie personal computer toct editing and word processing 
'tware does not consider the Afferent horizontal and vertical sizes of 
ferent fonts. Nor does it consider the widths of characters within a 
en font set. Therefore the formatting features of these text editors are 
c too us^iil when printing with 9am^9vtd. 

overcome this deficiency in existing personal computer software, 9am^ 
u provides its own horizontal and vertical formatting features, including 
rd wrap and justification. Thus, it is advisable to disable all formatting 
ictions of your word processor, and use those of 9an^9»nt instead. 

e procedure for printing with 9an^9»ni is as follows: 

1. Create a text file, possibly contrining 9a^ 9 tU embedded 
commands for font selection and formatting. 
i. Print the contents of the text file using Pfont, possibiy specifying 
a number of printing parametere. 

len creating the text file, the user should not use justification, centering, 
cination or other formatting features of the text editing or word 
cesring software. 

ou are using WordStar, do the following: 

Enter the document mode. 

Turn justification off (Control—O J). 

Use WordStar in the normal manner, however insert 9an^ 9»fU 
embedded commands to select fonts, center, justify, word wra^), 
and in general In place of dot commands. You will not actually 
see the results of these commands until you print the tmct. Do 
not use tabs (as WordStar expands these to spaces), but use the 
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\t command instead. 

Vhen finished editing, save your file in the normal manner. Print the 
ottfce text file you just created by using Pfont.. 

f you try to print a file created by the WordStar print feature, use the 
tout PG’ parameter so that Pfont will not try to paginate your text, 
"his is not recommended as WordStar will not be able to properly paginate 
our text due to different height and width characters. 

"o summarize, WordStar and most other word processors should be used 
rimarily for editing text and inserting commands. can 

hen be used to format and print your text. 
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font Messages 

lis appendix lists the messages displayed by Pfont. Three types of 
jssages are identified: 1) Error — an error has occurred that will most 
ely cause undesirable results. In some cases, will recover from 

B error properly; 3am^ ^^yrU will almost always continue printing. 2) 
arning — has encountered an unusual circumstance and displays 

formation regarding the circumstance. You don’t necessarily need to act 
but should consider if is behaving in the manner you expected. 

Informational — is presenting some information that represents 

•rmal processing. 

veral messages contain words from your text or words determined at the 
ne the message is displayed. In this appendix, such words are 
aracterized by bracketed words; for example, <number> is used to 
present some actual number and may appear in a displayed message ^ 
O’. 

lie messages are listed in alphabetical order based on the first character of 
le first word in the message. If the first word is of the type describerfi 
)ove, then the message will be found at the beginning of the list. 

The Messages 

— more — — press any key to continue Informational 

Description: More information is to be displayed than can fit on the 
screen at one time. At the end of each screenfull this message is 
displayed. 

Action: Press any key to allow the remaining information to be 

displayed. The profile ‘FancFont.pro’ allows you to indicate the size 
of your display to make sure this measure appears when 
appropriate. 

PfontOx.ovl> system file not foimd. Error 

jrpe ’Control—C’ to Quit, OR switch disks 
id type any other character to retry> 

Description: CP/M users only, one of the PFont overlay files can not be 
located. Pfont is divided into several sections in order to leave as 
much roQm in memory as possible for loading of fonts. Thus there 
are several files that comprise PFont. Each of these files must 
reside either on the currently logged disk or on the disk in drive A. 
Action: Make sure the indicated file is on the currently logged disk 

(switch disks if necessary) and type any character to continue. If 




o 
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you wish to quit, type a ‘Control—C\ 

ominand> command absolute only; 4; or — ignored, assuming 

absolute. Error 

Description: The <command> indicated should not be followed by a 

value that includes a ‘+’ or ’ sign. The command is intended to 

be absolute, not relative to some previous setting. The ‘+’ or 

sign is ignored. 

• - 

)mmand> ignored* Error 

Description: The indicated <command> was not recognized as a valid 
command and thus could not be processed. The command was 
skipped and will have no effect on the current use of 

>mmand> not recognized as a conunand — ignored. Error 

description: The <command> is not know by Pfont and hence cannot 
be processed. The indicated characters are ignored and not printed. 

nt name> too long for a font file name (maximum <si£e> 

characters) Error 

description: The <font name> cont^ains too many characters and thus 
cannot be a valid font name. The maximum number of characters 
is <size>. 

Action: Retype ' the <font name> using the appropriate number of 

characters, 

ame> not a valid font file Error 

description: The file <name> was found on the disk, but it is not a 

font file. 

ctiom Make sure the file is a good copy of a font file — 

recopy if necessary. 

ime> not valid, names not allowed Error 

description: The indicated <name> contains the character and is 
thus not a valid file name. 
ction: Do not use a file name that includes a 

ane>: No more room in memory (<number>) Error 

'escription: The Pfont program has run out of computer memory and 
can not continue. 

ction: Use fewer fonts and/or shorter substitution strings and header 
and footer lines. Your computer system must have a minimum of 
128K bytes memory (DOS) or 64K bytes (CP/M). 
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a]iie>: No more room in memory (<8i£e>) Error 

Deecription: Pfont has run out of available memory and can not 
continue. The program was attempting to find <size> memory 
characters for <name> and could not find enough memory. 

Action: Use fewer fonts, substitution strings, header and footer lines 

and retry. If problems persist, contact SoftCraft, Inc. 

umber> digits required for <command> — command ignored. Error 
Description: Exactly the indicated <number> of digits is required for the 
indicated <command>. The command cannot be processed and 
thus has been completely ignored. 

Action: Modify your text file, making sure to use the indicated number 

of digits. 

iumber> digits required for <conmiand> command — assuming leading 
O’s. Error 

Description: Exactly the indicated <number> of digits is required for the 
indicated <command>. Processing of the command continues, 
withing O’s inserted before the number to create the necessary 
number of digits. 

iumber> is not between <lower bound> and <upper boimd> Error 

Description: The indicated <number> is either less than <lower bound> 
or greater than <upper bound>. 

Action: Use a number that is within the indicated range (inclusive). 

ext> doesn’t match expected values Error 

Description: The indicated <text> doesn’t match the names of any 
parameters and thus could not be processed by Pfont. 

Action: Use a known parameter name. Pressing ‘?’ will indicate the 

known parameter names. 

ype> was expected Error 

Description: An item of the indicate <type> was expected, e.g. Real, 
Horizontal Measure, etc. 

Action: Use a valid element of the indicated type. 

irord> not included in list of expected inputs Error 

Description: The indicated <word> was not expected by Pfont and 
therefore could not be adequately processed. 

Action: Retype the word, or use ‘?’ to determine the list of expected 

input words. 

n’t find the file: fancfont.pro Error 

Description: The file FancFont.pro is neither on the currently logged 
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disk nor is it on the disk in drive A. This file must be available in 
order for ^wn^S'<yni to operate properly. 

Action: Make sure the file FancFqnt.pro is on the currently logged disk 

or on the disk in drive A and retry. | 

. v-\ ■ 

>an’t open ’<file name>\ Error 

Type ’Control—Z’ to Quit, or Switch Disks and type any other 
character to retry> 

Description: The indicated <file name> is not available on the logged or 

named disk drive. > 

Action: Switch diskettes so that the indicated file can be found by 

Pfont. Press any key to continue (after switch diskettes) or press 
the Control and Z keys to quit (Control—C for CP/M). 

enter command within center or right align command — ignored. Error 
Description: A center command appears following a center command. 

This combination cannot be processed by Pfont and hence the 
second center command is ignored and is not printed. 

Action: Remove the second center command or end the first center 

command with a \h command or a new line. 

♦ 

Command Indicator set to <character> Informational 

Description: <character> is the command indicator for this use 

of Pfont. Only characters preceded by this <character> will be 
processed as Pfont embedded commands. 

ontinuing input from parameter input file . . . Informational 

Description: The remainder of the parameter input file will now be 
processed. This occurs following a parameter error and after repair 
of the error. 

default Parameter: +<parameter> Informational 

Description: If no parameter is specified (i.e., no + or — preceding a 
parameter name), then the input will be assumed to be preceeded 
by the indicated <parameter>. 

^isk read error, end of file? Error 

Description: An error has occurred in the process of accessing 
information contained in a file on the disk. 

Action: Check the file to see that it is complete and not damaged. If 
possible, make a new copy of the file and make sure that the end 
of the file is properly marked according to the standards of your 
operating system. 
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Do you really wish to quit now (’y’ -or ’n’)? Informational 

Description: PFont can be interrupted if you type ‘Control—Z’ (CP/M 
users type ‘Control—C’). . After the interruption, this message is 
displayed to allow you to reverse your decision. 

Action: If you indeed want to stop using PFont, press ‘y’. Press ‘n’ 

to continue using PFont. 

Ending Pfont. Error 

Description: An error has occurred from which Pfont cannot recover, 
therefore Pfont is stopping. 

Action: Repair the error and rerun Pfont. 

Enter digit between ’0’ and ’<number>’ for horizontal draft 

mode: Informational 

Description: In response to the ‘Control—D’ interactive request, Pfont 
needs to know the desired rough draft mode. 

Action: Depre^ a numbered key between 0 and <number> inclusive to 

indicate the desired rough draft mode. 

Enter lines to be printed using keyboard. Informatimud 

Type ’Control—Z’ ’Return’ when done. 

Description: Pfont is being used in its electronic typewriter mode (a file 
name of ‘tty:’ or ‘con’). This message indicates that you should 
type lines of text to be printed Whenever you press the ‘Return’ 
key, the line will be printed. To finish printing and end Pfont, 
press the ‘Control—Z’ combination and then press the ‘Return’ key. 
There must be no other typing on the ending line. 

Enter printing parameters, for example: Inforrhational 

4 +FO Romnl2 RomnB12 +FI File.fr 

Then press RETURN (possibly more than once) to start printing. 
Type ’?’ for assistance at any time. 

This message provides an example of what you should type when 
using Pfont. ‘?’ can be used frequently to indicate your choice of 
input. 

Expecting <Parameter Value> — a <type> between <number> and 
<number>. Informational 

Current Value: ... 

Description: The value for the Indicated parameter is expected. <type> 
and ‘between <number> and <number>’ provide additional clues as 
to what is expected. The <number>’s represent the inclusive 
bounds for the value expected. If the parameter in question has a 
current or default setting, it will be indicated following the words 
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‘Current Value:’. 

pecting name of parameter input file* Error 

Description: The name of a file containing Pfont parameters was 
expected and was not received. 

Action: Try typing a different name, or a similar name that also 

includes a specific disk drive (e.g. A:name). 

ie looping’ without Files, canH continue. Error 

Description: You have used the special file name ‘loop:’ to indicate 
repeated printing of files, but have not indicated any files to be 
printed. 

Action: Use Pfont again, this time making sure to indicate a file to be 
printed before using ‘loop:’. 

e <file name> can’t be opened Error 

Description: The <file name> is not available for use. 9<yrU was 

unable to find and use the file. 

Action: Check that you have typed the name correctly; also be sure to 
prefix the file name with a disk drive name if not on the currently 
logged disk. For example, A:n 3 ine or B:name. 

e <name> not found Error 

Description: The indicated <name> could not be located on the logged 
disk drive. 

Action: Try entering a different name, or similar name prefixed with a 
disk drive specification (e.g. B:name). If no success, stop using the 
program and make sure the exact <name> you are using 
is on the currently logged disk. 

at file Xfile name> not available — can’t continue. Error 

Description: The indicated font <file name> could not be located on 
your disk and therefore Pfont cannont continue. 

Action: You have changed diskettes after indicating Pfont parameters 

and removed the diskette containing the <file name>. Rerun Pfont 
and do not switch diskettes. If necessary, copy fonts and/or files so 
that you won’t need to swap diskettes. 

it file <name> not found Error 

Description: The font file <name> could not be located on your 
computer’s disks. 

Action: Check and retype the name, making sure to use a disk drive 

name prefix if the font file is not on the currently logged disk (e.g., 
A:name or B:name). 
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orizontal Mark <number> not set — command ignored* Error 

Description: The horizontal mark number <number> has not been set 
by a \m command and thus cannot be used. 

Action: Be sure to use \m<number> before using \hm<number>. 

arizontal draft mode <number> set* Informational 

Description: The horizontal rough draft mode number <number> has 
been successfully set in response to the ‘Control—D’ interactive 
request. 

iproper numeric argument for <command> — command ignored* Error 

Description: The value following the indicated <command> does not 
conform to the expected value (for example, not a number). The 
entire command is ignored. 

iput line too long* Warning 

Description: Pfont has received too many characters on one input line. 

Subsequent characters will be ignored. 

Action: Start a new input line. 

isert or adjust paper — then type any character to print next 

page* Informational 

Description: Pfont has paused and is waiting for your approval before 
the next page is printed. 

Action: Press any key on the keyboard and the next page will be 

printed. 

Lvalid printer type in the file fancfont.pro Error 

Description: You have entered a printer type in the file FancFbnt.pro 
4 that is not recognized by your version of 
Action: Inspect the file FancFont.pro, check that the printer type is 

properly specified. If trouble persists, copy the FancFont.pro file 
from your distribution diskette. You might also try a synonym or 
more generic name for your printer. 

Lvalid y density request: <number> Error 

Description: The font you are using does not conform to the format of 
font file expected by your version of 

Action: Recopy the font file from your master diskette; it is likely 

damaged. 

ine length (<line length>) exceeds maximum length (<max length>), 
<number> characters* ^ Warning 

Description: The current line (displayed preceded by following this 

message) does not fit on the print line. The length of the line 
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(<line Iength>) is longer than the maximum <max length>. The 
line is <number> characters long. 

Action: Use word wrap (\w) and Pfont will automatically move words 

between lines to avoid this problem. Alternate solutions are to 
reduce the number of characters to be printed on the line or to 
increase the line width (+LW). 

[roading <font name> as font number <number> . « • in 

memory Informational 

Loading <font name> as font number <number> ... on disk 
Description: Pfont is preparing for printing by reading the character 
definitions from the file into memory. Printing is much faster if the 
font fits in memory. If the font does not fit, the message ‘... on 
disk’ is displayed to indicate that the character definitions must be 
used directly from the disk. The <font name> is successfully 
loaded either in memory or on disk as font number <number> for 
use with the embedded \f command. 


Aake sure printer is ^On Line^ Warning 

Description: Pfont is ready to start printing, but you must have your 
printer properly connected to your computer, have the printer 
plugged in, turned on and have the appropriate button or switch on 
your printer ‘on line’. 


FF fonts — command ignored. Error 

Description: You can not use the \ff command since the ‘4-FO’ 
parameter has not been used to Indicate the correspondence between 
Fancy Font font numbers and font names. 

Action: Specify the ‘+FO’ parameter and rerun Pfont. 


^o more room in list (maximum <munber>), <text> not used. Error 

Description: Too many iten^ have been placed in a list of values for a 
Pfont parameter. The message indicates the maxiinum number of 
items in the list and the item that would not fit. The indicated 
item will be ignored. 

Action: User fewer items, for example, fewer fonts or file names. In 
some causes you must use Pfont multiple times, in others you must 
combine multiple files into one file to continue. The Pfont list 
limits are reasonably large; thus this message may result from a 
usage error. 


b unit specified for <conimand> command — assuming ’<unit>’. Error 
Description: The indicated <command> should be followed by a value 
that includes a unit. The command was not followed by such a 
unit; so the indicated <unit> was assumed and processing continues 
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using this unit. . 

unit specified, assuming <iuiit>. Warning 

y Description: A unit (‘i’, ‘c’, ‘d’, ‘u’) was expected for a horizontal or 
vertical measure. The unit was not found, however the indicated 
unit was used. 

>Iot enough room for the font set arrays Error 

Description: The amount of available memory on your computer system 
is not adequate to hold the amount of information necessary to use 
all of the fonts you have requested, even if they reside on disk. 
Action: Reduce the number of fonts for the document and retry. 

Some space is taken up by substitution strings, header and footer 
lines and file names (+SU, +HL, +FL, +FI); if these are cut down 
to a minimum you may be able to use more fonts. 

Note: One or more lines printed with extra interline spacing* Informational 
Description: There is extra white space between at least two printed 
lines in your document. 

Action: This is an informational message and you need not correct the 
situation in most cases. The extra space is the result 14)# 
definition of the fonts used on the print lines. You must use the 
‘a’ command in Efont to properly set the ‘blank points’ for a font. 
The blank points indicate the extra, unused white space in a font 
and is taken into account when calculating interline spacing. 
Additionally, fonts that have a very tall or very deep character 
must leave room for that character. Thus extra white space will be 
left for all characters of such fonts. Again, the ‘a’ command of 
Efont will indicate the tallest and deepest characters of a font. 
^ This message will also be displayed if you attempt excess negative 
vertical motion with either \v or \1 when using —RV (see \1, \p, 
and RV parameter). 

Nothing left to delete. Warning 

Description: There are no parameters as yet unprocessed during Pfont 

error recovery, thus you can not delete any parameters. 

Number is too long Error 

Bad Integer in the profile, FANCFONT.PRO just before: ... 
Description: The file FancFont.pro contains either an unexpected 

number, or a number that is too large. 

Action: Inspect the file FancFont.pro, look for the text in the file 

displayed in the above message and determine if a reasonable 

number has been specified. If not, correct the numberOtherwise, 
make a copy of FancFont.pro from your distribution diskette and 
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retry. 

Page <page nimiber>, <niimber> Lines Informational 

Description: Page <page number> has been printed, it contained 
<number> lines of output. 

Page length (<yertical Measure>) is shorter than Top and Bottom 
margins (<Vertical Measure>). Page Length set to <Vertical 

Measiire>. -Error 

Description: The page length specified with the ‘+PL’ parameter is 
shorter than the sum of the lengths of the ‘+TM’ and ‘+BM’ 
parameters and thus Pfont can do no printing. Therefore, Pfont 
has set the page length to the indicated length. 

Parameter Input File> Informational 

Description: The name of a file containing Pfont parameters is expected. 
Action: Enter the name of a file, followed by a press of the RETURN 
key. Make sure to prefix the name with a disk drive specification 
(e.g. A:name) if the named file is not on the currently logged disk 
drive. 

'’ast last tab on line, tab ignored. Error 

Description: A tab command (\t or ‘Control—P) has been encountered 
while formatting that has no corresponding tab stop set. That is, 
there is not tab stop to the right of the position in the print line 
at which the tab was encountered. 

Action: Modify tab stops with the ‘+TB’ parameter, remove the tab 

from the text, or use \h or \i to achieve the desired horizonatal 
motion. 

^lease answer y or ’n’: 

Description: You have pressed a key other than ‘y^ or ‘n’ 
a question requiring a yes or no answer. 

Action: Press ‘y’ to answer yes, ‘n’ to answer no. 

^rint with Fonts, version x.x Informational 

Copyright (C) 1984 SoftCraft, Inc. 

Description: Introductory message. The number identifies this version of 
the program and helps you to determine whether you have the most 
recent revision. 

'rinting <file name> ... Informational 

Description: The indicated <file name> is currently being formatted and 
printer. The <file name> may be ‘tty:’ or ‘con’ if the special 
electronic typewriter mode is in use. 


Error 
in response to 
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Printing terminated after page <page number> Informational 

» Description: Pfont is ending after the indicated <page number>. This 

I; occurs when the ‘+LP’ parameter is used. 

¥'■ 

Printing will pause after current page. Informational 

Description: In response to the ‘Control—E’ interactive request, Pfont 

i will pause after printing the end of the current page. 

Profile backspace string too long Error 

Description: The file FancFont.pro allows you to customize how your* 
computer system responds to a backspace character. This message 
indicates that the indicated backspace specification exceeds the 
maximum 6 character length. 

Action: Modify the file FancFont.pro to contain a shorter backspace 

string specification and retry. If this problem persists, copy the 
original FancFont.pro file from your distribution diskette. 

Seal argument value Partial 

Description: A real number is expected. That is, a number that! ; 
have a fractional part (e.g. 1.45, 2, .56). 


Remaining input: <parameters> Informational 

(plus rest of parameter input file) 

Insert input or press ’RETURN^ to continue 
Control—D to delete next input word, Control—B to backup 
Control—X to ignore all remaining input and continue 
Description: An error in specifying Pfont parameters has occurred. The 
<parameters> have not yet been processed. The rest of the 
4 parameter input file (if any) also has not yet been processed. You 
have several options to repair the parameter error and continue to 
process all the remaining parameters. 

Action: Type new input to replace the erroneous input or use 

Control—D, Control—X or Control—B to repair, ignore etc. the 
remaining input. A ‘return’ will continue processing the remaining 
input. 


Result (<number>) of <command> command not between <number> and 
<number> — command ignored. Error 


Description: The value resulting from the indicated <command> is not 
within the allowable limits. The resulting value is indicated by the 
first <number> and the second and third <number>s represent the 
limit. The entire command is ignored. The resulting^ <number> 
may be different than the value indicated in the <command> due 
to unit conversion or a relative command. 
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Sht Alignment command within Bight Alignment command — 

ignored* Error 

Description: A right alignment command appears within a right 
alignment command. This combination cannot be processed by 
Pfont and hence the second right alignment command is ignored 
and not printed. 

Action: Remove the second right alignment command or end the first 

right alignment command with a \h or a new line. 


(ht Margin (<Hori£ontal Mea8ure>) larger than maximum (<8i£e>), 
reset to maximum* Warning 

Description: The sum of the line width and the left margin exceeds the 
maximum printing width (<size>) for your printer. The line width 
has been changed to fit the <size> of your printer. 

Action: If you have a wide printer, modify your profile to so indicate. 

For Epson printers, modify the file ‘FancFont.pro’ so the 
‘printer.type’is XXlOO rather than XX80 (where XX is FX, RX, or 
MX). 


igh draft mode error , Error 

lescription: An error has been encountered in reading information from 
a font file. 

\ction: It is likely that you are using a damaged font file. Make a 

new copy of the font file and retry. 

X error Error 

description: An error has been encountered in the process of accessing a 
character from a font that is stored on disk. 

Action: It is likely that you have a damaged font file. Make a new 

copy of the font file, and retry. 

pping to next file. Informational 

description: In response to a ‘Control—F’ interactive request, the 
remainder of the current file will be ignored and subsequent input 
text will be read from the next file in the ‘+Fr file list. 


^>pmg to page <page number>* Informational 

description: In response to a ‘Control—N’ interactive request, all pages 
until the page numbered <page number> will be skipped. 
(‘Control-P’ for CP/M). 

ag argument .value Informational 

escription: A string of characters is expected. 
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ring number <digit> not defined —'command ignored. Error 

Description: The substitution string (\s) numbered <digit> has not been 
defined with a +SU parameter and thus cannot be used. The \8 
command has been ignored. 

Action: Use Pfont again, this time making sure to use 4-SU as a 

parameter to define all the \s substitution strings used in your text. 

le Fancy Font System — loading Pfont . . • Informational 

Description: Your system may take some time loading the Pfont printing 
program. This message indicates that Pfont is being loaded, and 
that you must wait until it is ready for operation, 

lexpected end—of—file Error 

Description: has prematurely encountered the end of a file it is 

trying to use. 

Action: Check that all font and other files have been properly copied. 

Attempt to determine the file causing the error, make a new copy 
of the fie if possible, and retry. 

iknown FF Font — font 0 selected. Ewor 

Description: In switching from native fonts (\fn) to Fancy Font fonts 
(\ff), the current font number was set to a number not available for 
Fancy Font fonts. In order for printing to continue, Pfont is 
choosing to use Font 0 until instructed to do otherwise with a 
subsequent \f command. 

Action: Switch fonts before switching from native font printing to 

Fancy Font printing. 

\ 

iknown font (<font number>) — font not changed. Error 

Description: The <font number> font has not been specified with the 
‘+FO’ parameter and hence cannot be used. Pfont will not make 
the requested font change. 

Action: Specify the ‘+FO’ parameter and rerun Pfont. 

iknown string substitution command ^<cliaracter>^ — command 

ignored. Error 

Description: In a text file being processed by Pfont, there is a \s 
substitution command that is not recognized. Examples of valid 
commands are \sf, \s#. The <character> following \s in the file is 
not recognized and the entire \s command is ignored.- 

irtical Mark <number> not set — command ignored. Error 

Description: The vertical mark number <number> has not been set by a 
\n command and thus cannot be used. 

Action: Be sure to use \n<number> before using \hm<number>. 
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arning — Bottom Margin (<Vertical Measure>) less than Footer Margin 
(<Vertical Measure>). Warning 

Description: The bottom margin (‘.+BM’ parameter) is not large enough 
to contain the footer margin (‘+FM’ parameter). Results of 
printing will be unpredictable. 

Action: Increase the size of the bottom margin or decrease the size of 

the footer margin and rerun Pfont. 

aming — No fonts specified, choosing native printer fonts. Warning 

Description: The ‘+FO’ parameter has not been used, therefore all 
printing will be with the fonts native to your printer rather than 
the high quality fonts. 

aming — Right Margin (LW + LM) too large to allow for slanted 
characters; Warning 

suggest reduction by approx. %d dots. 

Description: The right margin (sum of line width and left margin) is too 
large to allow slanted characters to fit on the line. Since Pfont 
allows characters to have negative margins, some characters (such as 
a Roman T and most script and Italic characters) extent slightly 
past the right margin. This naessage indicates that there may not 
be enough room for such characters to extend into the right margin. 

Action: As recommended in the message, reduce either the line width 

or the left margin to by the indicated number of dots to allow 
room for character overhangs. 

iming — Top Margin (<yertical Mea8ure>) less than Header Margin 
(<Vertical Measure>). Warning 

')e8cription: The top margin (‘+TM’ parameter) is not large enough to 
contain the header margin (‘4-HM’ parameter). Results of printing 
will be unpredictable. 

\ction: Increase the size of the top margin or decrease the size of the 

header margin and rerun Pfont. 

rning — no printing or display, 0 copies requested. Warning 

escription: You have indicated ‘+NC 0’ or ‘—NC’ as a Pfont 
parameter. This results in no printing or processing and is most 
likely a mistake. 

ction: Run Pfont again without the ‘NC’ parameter. 

oing: Native/Fancy font selection not at beginning of line — Warning 

formatting errors likely. 

scription: A .selection of \ff for Fancy Font fonts or \fn for native 
printer fonts should occur at the beginning of a print line. If not. 
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formatting problems are likely since Pfont will assume that all 
printing is to be done in the last type of fonts specified. 

Action: Use a \b immediately preceding the \ff or \fn command. 

aming: this font is not compatible with this veroion of the 

pro^am Warning 

Description: The font is for a different version of the program and will 
not work properly with the version of the program you are using. 

Action: Use a different version of the program or a different font. In 
some cases, different font versions may be used to achieve unusual 
effects. 

ord split, too long for print line. Warning 

Description: When using word wrap (\w), a word is so long that it 
cannot fit on a printed line without being split. Pfont splits the 
word, putting the first part on the current print line and the 
remainder on the next print line. 

Action: Avoid using very long words and very short line lengths. 

Alternatively, hyphenate the word by placing ’ (a hyphen 
followed by a space) within the word. 

.. for help, ... (or ...) for file input, ... to review parameters^ Informational 
’Control—V’ for general help, ’RETURN’ to end list or start 
processing, or 

’Control—U’ to erase input line. Type ’Control—Z’ to abort and 
exit. ] 

Description: An informational message to remind you of the special 
characters used by Pfont. The first character can be used for help, 
the second and (third) to obtain parameter input from a parameter 
input file, and the fourth to review the current settings of all the 
^ parameters. The remaining lines indicate additional special 
characters. (CP/M users should press ‘Control—C’ instead of 
‘Control—Z’). 
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font Messages 

ready exists. Do you want to overwrite it 

When you try to create a file (e.g., in the save or edit commands) 
and a file of that name already exists you will be offered the 
opportunity to overwrite the old file or give a new name. Answer ‘y’ 
to the prompt if you want to overwrite the old file or ‘n’ if you do 
not. In the latter case the program will request an alternative name. 

mk points (top)=<integer>, blank points (bottom) =:<iQteger> 

This is an informational message indicating the ^blank points’ values 
for a font. See section E.2 for a discussion of these values. 

n*t create <filename>; try another name. 

If you try to create a file (e.g., in the save or edit conunands) and 
that file cannot be created then this prompt will allow you to give 
another name. Most likely you are out of space on the disk or you 
typed an invalid file name. Give another file name, perhaps on a 
different drive (e.g., b:newfile.fon). 

find the file: lancfont.pro 

Efont needs to read the file ‘fancfont.pro’ when it starts up in order 
to determine what type of printer is being used. Make sure 
‘fancfont.pro’ is either on the currently logged drive or on drive A. 

I’t open file: <filename>; try another name. 

If, when trying to read a file (e.g., in the load or edit commands), 
that file cannot be opened this message and prompt will allow you to 
try a different file name. You may have mistyped the file name. Try 
to type it again. Be sure to include the drive specifier (e.g., 
b:myfont.fon) if the file is on a disk other than the currently logged 
drive. 

swap In <filename>; is it on the default disk? 

This arises on CP/M systems only. The Efont overlay files 

(EFONT’^.OVL) must be on the current disk or on drive A. You 
should copy the overlay files to the current disk or to drive A, or log 
to the disk containing the overlay files before starting up Efont. 

anging the right margin of character #<integer> to <Integer> 

Negative overall character widths are not allowed. When negative left 
or right character margins (see the margins command) would result in 
a character, with negative width this message is displayed indicating 
that the right margin has been reset to make the character have 
width zero. No action is required. 
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aracter ’A’ is not the highest character 

Top blank points is computed for a font only if ‘A’ is the tallest 
character and ‘p’ is the lowest. This message is displayed simply to 
inform you that these values are not being computed. See the auxinjo 
command and section E.2 for a discussion of blank points values. 

aracter is not the lowest character 
Top blank points is computed for a font only if ‘A’ is the tallest 
character and ‘p’ is the lowest. This message is displayed simply to 
inform you that these values are not being computed. See the auxinfo 
command and section E.2 for a discussion of blank points values. 

aracter is too high, y=<integer> 

During a replace command a character was found to have dots in it 
at a vertical location exceeding the maximum value. Section E.3 
describes the maximum character size. The character will be clipped 
down to the allowable size. If the character is less than one inch in 
overall height, reduce the ptop value to an allowable value and replace 
again. 

aracter is too low, y=<integer> 

During a replace command a character was foimd to have dots in it 
at a vertical location lower than the minimum value. Section E.3 
describes the maximum character size. The character will be clipped 
down to the allowable size. If the character is less than one inch in 
overall height, increase the ytop value and replace again. 

aracter is too wide, x=<integer> 

Enuring a replace command a character was found to have dots in it 
at a horizontal location exceeding the maximum value. Section E.3 
describes the maximum character size. The character will be clipped 
down to the allowable size. If the character is less than one inch 
wide you probably have blank columns at the left edge of the ‘.edf 
file. Move the asterisks left to the left edge of the file and replace 
again. 

In’t find any characters in that range to replace 

The range of characters provided during the replace command did not 
correspond to any ‘a<nnn>.edF files on the current disk. * Perhaps you 
need to be logged to a different drive (i.e., to the one containing the 
‘.edf files) before starting Efont. 
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yyk read error^ end of ffle? 

There was an error in trying to read from a font file. The disks 

containing the font files must remain in the computer throughout 

execution of Efont so make sure you haven’t removed any disks after 
starting Efont. This message may also indicate a bad font file. See 
the ‘Shouldn’t happen; bad alloc’ message for options in the latter 
case. 

)iak write error. Out of space? 

You are probably out of space on the disk to which a file is being 

saved. If this occurs during a save command try to save to a 

different disk (e.g., b:myfont.fon). K this occurs during a edit 
operation you will need to save the current font if necessary, get out 
of Efont, make space available or log to another disk, and then 
reenter Efont and try again. 

hqiecting an integer 

This message is displayed when the program is reading from a file and 
is expecting to find an integer. If the message occurs immediately 
upon startup of the program then there is probably a syntax error in 
the profile file, ‘fancfont.pro’. If you have recently modified this file 
check it against the original and make sure all integers look right 
(e.g., make sure you don’t have ‘oh’ for ‘zero’) and make sure the 
commas and spaces are still present in the file. If this message occurs 
during a replace command the context of the message should identify 
where the problem is. Check the first three numbers in the 
replacement file. See the replace command for more discussion on 
‘.^f file format. 

ivalid character^ <hex> (hex), Ignored; it should be an asterisk or a 
space. 

The file read by the replace command should have only asterisks, 
spaces, carriage returns and line feeds in it. This message identifies 
an unexpected character in the replacement file. See the replace 
command for more discussion on file format. 

ivalid conunand indicator, ’\...’ 

Only a small number of Pfont emb^ded commands are allowed in the 
ieetstring command. See the teststring command for a list of allowable 
commands. You probably had a backslash ‘\’ in the string to be 
printed followed by something other than one of the allowable 
commands. 
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ivalid printer type in the file lancfont.pro 

The printer type in the file ‘fancfont.pro’ is not one of the allowable 
types. Check to see that the string of characters between 
‘printer.type’ and the following comma is one of the allowable printer 
types (see Appendix 5 for the list of allowable types). 

OLYalid y density request: <integer> 

This probably indicates a bad font file. See the ‘Shouldn’t happen; 
bad alloc’ message for options. 

fegative character widths are not allowed. 

Negative overall character widths are not allowed. When negative left 
or right character margins (see themar^fina command) would result in a 
character with negative width this message is displayed indicating that 
the right margin has been reset to make the character have width 
zero. No action is required. 

fo more room 

There is not enough memory left to replace any more characters. Try 
to save the font as it is, exit Efont, restart Efont, load the font and 
then continue replacements. If the font is simply too large to fit 
memory (quite possible on CP/M machines) there is nothing that can 
be done; you must split the font in two and use it as two separate 
fonts (i.e., save the font as it is and do the rest of the replacements 
in another nm of Efont and then save as another font). 

^ot a fill! ASCn font set 

Top blank points is computed for a font only if ‘A’ is the tallest 
character and ‘p’ is the lowest. This message is displayed simply to 
^ inform you that these values are not being computed. See the auxinfo 
command and section E.2 for a disctission of blank points values. 

Yot a valid font file 

All fonts begin with some identifying information to distingiiish font 
files from other files. This information was not there for the font you 
just tried to load. This probably indicates a bad font file. The file 
may been copied incorrectly from the original disk. If it was 
generated from Cfont you may have run out of space during the font 
generation phase (there would have been a message to that effect). 
Try to recopy the font from the original disk or regenerate it from 
Cfont. 
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^ot computing blank top points 

Top blank points is computed for a font only if ‘A’ is the tallest 
character and ‘p’ is the lowest. This message is displayed simply to 
inform you that these values are not being computed because either 
‘A’ or ‘p’ is not defined in the font. See the axixinfo command and 
section E.2 for a discussion of blank points values. 

(ot enough memory for font editing 

You do not have enough memory in your computer to even begin 
execution of Efont. There is nothing to do but try to run it on a 
computer with more memory available to application programs. 

lot enough memory for the whole font: nothing loaded 

The size of the font you tried to load is larger than the available 
memory. Sometimes a font can be loaded if the load command is the 
first command issued in a run of Efont, so you might try to start 
Efont afresh and load the font again. 

lot enough room for the font set arrays 

You do not have enough memory in your computer to even begin 
execution of Efont. There is npthing to do but try to run it on a 
computer with more memory available to application programs. 

umber is too long 

This message is displayed when the program is reading from a file and 
is expecting to find an integer. K the message occurs immediately 
upon startup of the program then there is probably a syntax error in 
the profile file, ‘fancfont.pro’. If you have recently modified this file 
check it agsdnst the original and make sure all integers are less than 
20 digits long. If this message occurs during a replace command the 
context of the message should identify where the problem is. Check 
the first three numbers in the ‘.edf file. 

rofile backspace string too long 

The list of hex digits provided for ‘backspace.output.8tring’ in the 
profile file ‘fancfont.pro’ is too long; it must be four bytes or less. If 
you have modified this file recently check the syntax of the current 
file against the original and make sure the list of bytes provided for 
backspace string is length 4 or less. 

ough draft mode error 

This probably indicates a bad font file. See the ‘Shouldn’t happen; 
bad alloc’ message for options. 
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ShouldnH happen; bad alloc calcnhitipn 

This probably indicates a bad font file. The file may been copied 
incorrectly from the original disk. K it was generated from Cfont you 
may have run out of space during the font generation phase (there 
would have been a message to that effect). Try to recopy the font 
from the original disk or regenerate it from Cfont. 

ShouldnH happen; the bitmap for ’A* is wrong 

This probably indicates a bad copy of the Efont program. Try to 
recopy from the original disk. This message may occur intentionally 
(and without iU effect) when Efont is used in ‘Auto Replace’ mode. 

Shouldn’t happen; the bitmap for ’p’ is wrong 

This probably indicates a bad copy of the Efont program. Try to 
recopy from the original disk. This message may occur intentionally 
(and without ill effect) when Efont is used in ‘Auto Replace’ mode. 

Sorry, no default here. Enter a number between <integer> and 
<integer» 

The previous prompt for a number does not allow for carriage return 
(or enter) alone as a response. That is, there is no default value^^er 
this prompt. You must type in a number explicitly. 

The font height has changed. The new values are: 

A replace or zap command has caused the overall height of the font to 
change (see the command descriptions for reasons why this happens). 

There are no command line parameters required 

You typed some parameters on the command line when you started 
Efont. All Efont commands are interactive and no parameters are 
^ required. Simply continue in Efont after this message. 

Top row=<lnteger>, Bottom row=<integer> 

See section E.2 for the meanings of these numbers for a font. 

Unexpected end—of~file 

There is something wrong near the end of the file ‘fancfont.pro’. If 
you have recently modified this file check it against the original and 
make sure all integers look right (e.g., make sure you don’t have ‘oh’ 
for ‘zero’) and make sure the commas and spaces are still present in 
the file. 
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Earning: this font is not compatible with this version of the program 

Each printer type requires a different version of the programs (Pfont, 
Efont and Cfont). The font you tried to load was not made for this 
version of Efont. 
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Jfont Messages 

ictually, not enough memory to print at any scale factor 

Your computer does not have enough memory to use the print 
command. There is nothing that can be done. 

Uready exists. Do you want to overwrite it 

When you try to create a file (e.g., in the save or generate commands) 
and a file of that name already exists you will be offered the 
opportimity to overwrite the old file or give a new name. Answer ‘y’ 
to the prompt if you want to overwrite the old file or ‘n’ if you do 
not. In the latter case the program will request an alternative name. 

Bad scale factors or baseline; they must be Integers 

This message occurs during automatic (command line) operation of 
Cfont. There is probably some error in the command line parameters. 
See section C.2 for a description of the required command line 
parameters. 

Can’t create <filename>; try another name. 

If you try to create a file (e.g., in the save or generate commarKir) 
and that file cannot be created then this prompt will allow you to 
give another name. Most likely you are out of space on the disk or 
you typed an invalid file name. Give another file name, perhaps on a 
different drive (e.g., b:newfile.fon). 

Can’t find HEESHEY.CHE. Hershey file name> 

Normally the file ‘hershey.chr’ should be on drive A or you should be 
logged to the disk containing the Hershey database when running 
^ Cfont. However, if this is not the ease you will be prompted with 
this message for the location of the database file (e.g., ‘mrhershey.chr’ 
if you have the database file on an electronic disk). 

Can’t find the file: fancfont.pro 

Cfont needs to read the file ‘fancfont.pro’ when it starts up in order 
to determine what type of printer is being used. Make sure 
‘fancfont.pro’ is either on the currently logged drive or on drive A. 

Can’t open file <filename>; try another name> 

If, when trying to read a file (e.g., in the load coipmand), that file 
cannot be opened this message and prompt will allow you to try a 
different file name. You may have mistyped the file name. Try to 
type it again. Be sure to include the drive sp^ifier (e.g., 
b;myfont.map) if the file is on a disk other than the currently logged 
drive. 
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jk read error, end of file? 

There was an error in trying to. read from the temporary font file 
produced during the generate command. The disk containing the 
temporary font file must remain in the computer throughout execution 
of Cfont so make sure you haven’t removed any disks after starting 
Cfont. 

ijk write eiror. Out of space? 

You are probably out of space on the disk to which a file is being 
saved. If this occurs during a save command try to save to a 
different disk (e.g,, brmyfont.fon). K this occurs during a generate 
operation you will need to save the current mappings if necessary, get 
out of Cfont, make space available or log to another disk, and then 
reenter Cfont and try again. 

id of database file. LooUng for continuation. 

This should only arise on Osborne and other low—capacity disk 
systems. Cfont needs to find the file ‘hersheyl.chr’ so respond to the 
prompt with the name of this file, including the drive specifier (e.g., 
c:hersheyl.chr). 

pecting an integer 

This message is displayed when the program is reading from a file and 
is expecting to find an integer. There is probably a syntax error in 
the profile file, ‘fancfont.pro’. K you have recently modified this file 
check it against the original and make sure all integers look right 
(e.g., make sure you don’t have ‘oh’ for ‘zero’) and make sure the 
commas and spaces are still present in the file. 

^nt set char no. must be between 0 and 137; 

You tried to specify a mapping to an ASCII code greater than 127. 
Type another number, this time between 0 and 127. 

ive to skip over <integer> characters in the Hershey file so ... 

This is just a warning that the next step of the generate or print 
command may take a long time. 

arshey character #<integer> is wider than its defining box. 

Tl^ probably indicates that the Hershey database file, ‘hershey.chr’ 
has been corrupted. Try to copy it over again from the original disk. 
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it any key to contInue> 

The screen freezes when it fills up with information. Type any key to 
display the next screenful! of information. 

ivalid printer type in the file lancfont.pro 

The printer type in the file ‘fancfont.pro’ is not one of the allowable 
types. Check to see that the string of characters between 

‘printer.type’ and the following comma is one of the allowable printer 
types (see Appendix 5 for the list of allowable types). 

ivalid y density request: <integer> 

This probably indicates a bad temporary font file. See the ‘Disk read 
error* message. 

lo mappings deleted 

The zap command was given a range of characters that did not 
include any of the currently mapped characters. If you really wanted 
to remove some of the mappings you probably mistyped one of the 
character range bounds and therefore nothing happened. 

(o mappings yet 

There are no mappings from ASCII codes to Hershey character 
numbers currently in effect. Either none have been provided or all of 
them have been removed (with zap). 

iot enough memory to plot charactm 

Your computer does not have enough memory to use the generate 
command. There is nothing to do but try to run it on a computer 
with more memory available to application programs. 

t^ot ^enough memory to print at that scale factor 

This is simply a warning that some of the ch^acters may be clipped 
during the print command due to memory limitations. You may still 
be able to generate full—sized characters however. 

fot enough room for the font set arrays 

You do not have enough memory in your computer to even begin 
execution of Cfont. There is nothing to do but try to run it on a 
computer with more memory available to application programs. 

# 

^lumber is too long 

This message is displayed when the program is reading from a file and 
is expecting to find an integer. If the message occurs immediately 
upon startup of the program then there is probably a syntax error in 
the profile file, ‘fancfont.pro’. If you have recently modified this file 




o 
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check it against the original and make sure all integers are less than 
20 digits long. If this message occurs during a load command the 
context of the message should identify where the problem is. 

r<^e backspace string too long 

The list of hex digits provided for ‘backspace.output.string’ in the 
profile file ‘fancfont.pro’ is too long; it must be four bytes or less. If 
you have modified this file recently check the syntax of the current 
file against the original and make sure the list of bytes provided for 
backspace string is length 4 or less. 

ough draft mode error 

This probably indicates a bad temporary font file. See the ‘Disk read 
error’ message. 

^me characters may be clipped 

See the ‘Not enough memory to print at that scale factor’ message. 

^rry^ no default here. Enter a number between <lnteger> and 
<integer» 

The previous prompt for a number does not allow for carriage return 
(or enter) alone as a response. That is, there is no default value for 
this prompt. You must type in a number explicitly. 

c font file is too large. The sise is more than <integer> Kbytes 

Font files currently have a maximum size of 64K bytes and you tried 
to generate a font larger than that. You must either reduce the scale 
factors and generate again or remove some of the characters from the 
mapping specification. One option is to cut a font into two parts by 
placing uppercase letters in one font and lowercase letters and 
punctuation in another font. 

ue named file Is not a valid mapping file. It looks ... 

The load command is sometimes mistakenly used to load font files 
instead of mapping files into Cfont. See the description of the load 
command. 

tp row=<iQteger>, bot row=<integer >9 top blank=<integer>, bot 
blank=<integer> 

See section E.2 for the meanings of these numbers for a font. 

i expected end-of~file 

There is something wrong near the end of the file ‘fancfont.pro’. Jf 
you have recently modified this file check it against the original and 
make sure all integers look right (e.g., make sure you don’t have ‘oh’ 


Appendix 4 — Cfont Messages 

for ‘zero’) and make sure the commas and spaces are still present in 
the file. 



Notes 
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prog.exe> These are executable DOS programs. <prog> is one of 

Pfont, Efont, or Cfont. 


prog.coin> These are executable CP/M programs. <prog> is one of 

Pfont, Efont, or Cfont. 

overlay>.ovl These are the CP/M overlay segments for either Pfont or 

Efont. Pfont overlays may reside on the CP/M logged in 
disk or on disk Efont overlays must reside on the CP/M 
logged in disk. 

fontJilp This is a help file for Pfont. It should reside on the 

currently logged in disk or on drive If not present, 

Pfont help will continue to work properly, except for the 
‘Control—V’ general help. 

fcmtJile This is a help file for Pfont following parameter input errors. 

It should reside on the currently logged in disk or on drive 
‘A‘. ff not present, ‘?’ used following a ‘<E>’ error prompt 
will provide no assistance. 

:fileJ!r> This is the conventional file name extension for 

(input) text files. The ‘IT extension is not required or 
specially recognized by any programs; it is strictly 

an informative convention. 


Iflle*ffl> This is the conventional file name extension for Pfont 

parameter files. For example, ‘Pfont Qletter.ffi myletter.fP 
would be useful if ‘letter.ffi’ defined the standard . letter 
^ format (page size, letterhead, etc.). 

.ersheyxhr This is the Hershey character database used by Cfont. If it 

is on the logged in disk or on drive ‘A’, Cfont will find it 
automatically, otherwise Cfont will ask for the disk and file 
name where it can be found. The Osborne distribution 
package provides ‘hershey.chr’ in two halves (hershey.chr and 
hersheyl.chr) due to disk capacity limitations. 

incfont«pFO This is a configuration profile file, describing a few aspects of 

your computer system and printer. It is used by Pfont, 
Efont and Cfont to determine and adapt to the type of 
pointer you are using, and by Pfont to adapt to the size of 
your display screen. The profile may be modified using your 
text editor (WordStar users, make sure to use non—document 
mode). See the end of this appendix for details. 
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<fontnaineJ!an> 


These are the font files. The ‘fon’ extension !• 
assumed by Pfont if no extension is pven to the argument! 
to the *+FO’ parameter. For example, ‘+FO Ronml2’ || 
equivalent to ‘+FO Ronml2.fon’. 

<fontname> adheres to the foUowing conventions: 








<style> { <face> } <size> { <8uper8ub> } 

where {<...>} indicates an optional element. <style> is an 
abbreviation for the style of the font, ‘romn’, ‘sans’, ‘olde\ 
and ‘scrp’ for Roman, Sans Serif, Old English, and Script 
respectively. <face> is optional and can be ‘i’ or ‘b’ for 
italic and bold. <size> is the size of the font in printers 
points (generally the distance from the bottom of the lower 
case descenders to the top of the upper case letters, 
measured in 1/72 inches). <supersub> is optional and is 
either ‘p’ for superscript or ‘b’ for suBscript. 




The ‘fancfont.pro’ Profile 

rhe file ‘fancfont.pro’ must be used in conjunction with all of the 9am^99mJi 
irograms to identify the type of printer you are using. You may edit the 
contents of the profile, but be careM not to add any extraneous 
haracters, blank lines or spaces. 

The standard profile is configured for IBM computers and Epson ‘80’ 
>rinters for DOS packages and your CP/M system and Epson ‘80’ printers 
or CP/M packages. There are a few pre—configured profiles that you can 
ename ‘fancfont.pro’ rather than editing the existing profile. These are as 
allows: 

fancfont.eps all Epson printers 

fancfont.gem all Gemini printers, generic MSDOS computers 

fancfont.dos generic MSDOS and Epson printers 

fancfont.ibm IBM computers and Epson printers 

o use one of these profiles, instead of the standard profile, on DOS 
/stems, type: 

copy fancfont.nsv fancfont.pro 

1 CP/M systems, type: 

pip fincfont.pro«fancfont.nav 

here ‘new’ stands for one of the extensions listed above (e.g. ‘gem’). 
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^ components of the profile are: 


rlatar.tTp* <tjf> {p»T«ll«l> <type> ie mxjx,rx foliotoed by 

80 or 100 (e.g. mx80, fxlOO) or geminilOx or geminilSx for all 
gemini printers; {parallel} is optional, it should be used with 
IBM and compatibles to speed-up printing under DOS 2.0 and above. 
ionBbsr.of .coluans.o&.scraan 80, normally 80, change number if desired 

miBbsr.ef .rews.oB.scrsna 24, normally 84, change number if desired 

backapaea.ksy.li^t.cod* 8, normally 8, the decimal ASCII character code 

for the bcukspace key on your keyboard 
backspaca.output.strlnf 8 32 8; a list of decimal ASCII characters to be 

sent to your display to delete the previous character 

>^e Epson MX, RX and FX printers are all very similar; however 
specifying FX80 will change the operation of Pfont in two significant ways, 
1) the default left margin (+LM) wUl be .75 inches and 2) reverse paper 
motion (+RV) will be enabled. 

i. ■ 

To be able to print the full width of wide printers, make sure to change 
your profile (e,g. mxlOO, fxlOO or geminil5x) to indicate the type of 
printer, and also increase the line width (+LW) as desired. 




Notes 




Appendix 6 — Hershey Character Database 

This appendix contains a complete listing of the Hershey database. 
It has been photographically reduced for inclusion in this manual 
80 you should print a copy on your own printer for use with 
Cfont. Part C of the manual describes a simple procedure to print 
the entire database. 
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Appendix 7 — Data File Formats 

There are only two types of data files, the font files and the Hershey 
character database file. 


FONT FILES 

The font files have the following format. 
bytes description 


0 to 29 

30 

31 to 32 

33 to n 
n+1 
n+2 
n“f"3 

n+4 

n+5 

n+6 to n+15 
n+16 to n+24 


- ♦ 



Id string, ‘Translation by SoftCraft, Inc.’. No trailing zero. 
Font file version number. 

Number of ‘ink’ data bytes in the file (see below). Low 
byte, high byte. 

Commentary text terminated with a zero. Variable length. 
A constant relating to the X density of the font. 

A constant relating to the Y density of the font. 

Top blank points (see section E.2 and the Efont auxinfo 
command). 

Bottom blank points. 

Number of characters defined in the font, including spaces. 
Reserved but currently unused. 

These nine bytes define the height, width, and relative 
vertical and horizontal locations of the first character in 
the font. Immediately following these bytes are nine 
similar bytes for the next character, then nine for the next, 
and so on until all characters (byte n+5) are defined. The 
characters are arranged in increasing ASCII order. The 
nine bytes are defined as follows; 

1 ASCII number. 

2 to 3 Box width (left margin + right margin + ink 

width). A two byte integer (low byte, high 
byte). 

4 to 5 Left msurgin (the starting location of the ink 

inside the box). A two byte integer (low byte, 
high byte). 

6 to 7 Ink width. A two byte integer (low byte, high 
byte). 

8 Ink height in rows (8 points, 24 dots per row for 
the Epson MX and FX version). 

9 Row number (offset by 128) of ink bottom. The 
top row is this value plus ‘the ink height. 
Section E.3 describes these parameters. 




Appendix 7 — Data File Fonnats 

[ERSHEY FILE 

'he Hershey character database has the following format. The first two 
ytes in the file are zero and are not used. Each character in the database 
I defined by a list of plotting directives and is best explained in terms of 
pen plotter. The first two bytes in the character description are the 
idth bytes and are not used by Cfont except for space characters. Each 
ibsequent plotting directive is a two—byte entry that is either the 
)ordinate of a new pen location or a special indicator. The special 
idicators are octal value 40000 specifying ‘pen up’ and 0 indicating the 
ad of the character. Values other than these are coordinates to move the 
en to, drawing a line if the pen was down, or just moving if the last 
alue was ‘pen up’ (any pen movement implies that the pen is lowered at 
le end of the movement regardless of its state before the move). The 
•ordinates are expressed as and ‘x^^ta’ bytes, in that order, and are 

otted by Cfont at ‘x^ord’ ‘ycoord’ according to the following equations. 

X.«„rf=(Xd^a-64 * xl/x2) 

yeoord=(68-yd.u * yi/y2) 

here xl, x2, yl, and y2 are the scale factors as described in the Cfont 
ctors command. Xcoord should be centered around 0 for the best possible 
lowable range of scaling factors, and the margins will be automatically set 
1 (they can be changed with Efont). equal to zero will be set at 

e baseline as specified by the Cfont baseline command (default value of 
/en). The above equations are modified slightly for character numbers 
^ater than 88. The constant, 68, in the equation for ycooid ^ follows: 
aracters 0 through 88, 68; 89 through 396, 73; 397 through 672, 70; 673 
, 73. The left and right margins are always set to one except as follows; 
aracters 0 through 215, 1; 216 through 241, 0; 242 through 1075, 1; 1076 
rough 1101, 0; 1102 on, 1. 




Appendix 8 — ASCII Conversions 



char dec 

oct 

hex 


char dec 

oct 

hex 

Dull 

‘0 

0 

0 

0 

• 

0 

64 

100 

40 


*A 

1 

1 

1 


A 

65 

101 

41 



2 

2 

2 


B 

66 

102 

42 


*0 

3 

3 

3 


0 

67 

103 

43 


‘D 

4 

4 

4 


D 

68 

104 

44 


*E 

5 

5 

5 


E 

69 

105 

45 


‘F 

6 

6 

6 


F 

70 

106 

46 

bdl 

Q 

7 

7 

7 


0 

71 

107 

47 

buckspace 


8 

10 

8 


H 

72 

no 

48 

tab 


9 

11 

9 


I 

78 

111 

49 

linefeed 

‘J 

10 

12 

A 


J 

74 

112 

4A 


*K 

11 

13 

B 


K 

75 

113 

4B 

formfeed 

‘L 

12 

14 

0 


L 

76 

114 

40 

return 

‘M 

13 

15 

D 


M 

77 

115 

4D 


*N 

14 

16 

E 


N 

78 

116 

4E 


‘O 

15 

17 

F 


0 

79 

117 

4F 


‘P 

16 

20 

10 


P 

80 

120 

50 


‘Q 

17 

21 

11 


Q 

81 

121 

51 



18 

22 

12 


R 

82 

122 

52 


•s 

19 

23 

13 


S 

83 

123 

53 


*T 

20 

24 

14 


T 

84 

124 

54 


‘U 

21 

25 

15 


U 

85 

125 

55 


•V 

22 

26 

16 


V 

86 

126 

56 


•w 

23 

27 

17 


W 

87 

127 

57 


*x 

24 

30 

18 


X 

88 

130 

58 


"Y 

25 

31 

19 


Y 

89 

131 

59 


‘Z 

26 

32 

lA 


Z 

90 

132 

5A 

eac^e 

‘1 

27 

33 

IB 

left bracket 

1 

91 

133 

5B 



28 

34 

10 

backslash 

\ 

92 

134 

50 


•1 

29 

35 

ID 

right bracket 

1 

98 

135 

5D 


A A 

30 

36 

IE 

circumflex 

A 

94 

186 

5E 


A 

31 

37 

IF 

underscore 


95 

187 

5F 

space 


32 

40 

20 

backquote 

1 

96 

140 

60 

exclamation 

1 

33 

41 

21 


a 

97 

141 

61 

quote 

• 

34 

42 

22 


b 

98 

142 

62 

hash 

# 

35 

43 

23 


- c 

99 

143 

63 

dollar 

t 

36 

44 

24 


d 

100 

144 

64 

percent 

% 

37 

45 

25 


e 

101 

145 

65 

ampersand 

dc 

38 

46 

26 


f 

102 

146 

66 

apostrophe 

» 

39 

47 

27 


6 

103 

147 

67 

left paren 

( 

40 

50 

28 


h 

104 

150 

68 

right paren 

) 

41 

51 

29 


• 

1 

105 

151 

69 

asterisk 

a 

42 

52 

2A 


• 

J 

106 

152 

6A 

plus 

+ 

43 

53 

2B 


k 

107 

158 

6B 

comma 

* 

44 

54 

20 


1 

108 

154 

60 

mim» 

- — 

45 

55 

2D 

- 

m 

109 

155 

6D 

period 

• 

46 

56 

2E 


n 

no 

156 

6E 

slash 

/ 

47 

57 

2F 


0 

111 

157 

6F 


0 

48 

60 

30 


P 

112 

160 

70 


1 

49 

61 

31 


q 

118 

161 

71 


2 

50 

62 

32 


r 

114 

162 

72 


3 

51 

63 

33 


s 

115 

163 

78 


4 

52 

64 

34 


t 

116 

164 

74 


5 

53 

65 

35 


u 

117 

165 

75 


6 

54 

66 

36 


V 

118 

166 

76 


7 

55 

67 

87 


«r 

119 

167 

77 


8 

56 

70 

38 


X 

120 

170 

78 


9 

57 

71 

39 


y • 

121 

171 

79 

colon 

• 

♦ 

58 

72 

3A 


t 

122 

172 

7A 

semicolon 

• 

f 

^9 

73 

3B 

left brace 

{ 

123 

173 

7B 

less than 

< 

60 

74 

30 

vertical rule 

1 

124 

174 

70 

equal 

as 

61 

75 

dD 

right brace 

) 

125 

176 

7D 

greater than 

> 

62 

76 

3E 

tUde 


126 

176 

7E 

question 

? 

63 

77 

3F 

delete 

DEL 

127 

177 

7F 




Appendix 9 — Parameter and Command Summary 
Pfont Embedded Formattfaig Commanda 


rU Selection Commands page 

:diglt> Select font number 17 

Select previous font 
Select native printer fonts 
Select Fancy Font fonts 

,digit> Select horizontal rough 
draft 15 

Underline on/off 39 

Continuous underline on/off 47 

Format Control Commands 
Temporary no justify/word wrap 12 


Center text 13 

Justify on,/smooth’right margin 24 
Justify off, ‘ragged’ right margin 26 

Right align text 34 

Word wrap on, fill and wrap lines 42 

Word wrap off 44 

<hm> Indent from left margin 49 
:<hm> Indent from right margin 50 


Miscellaneous Commands 

Reverse background on/off 45 

Comment, ignore text 52 


Horizontal Motion Commands page 

\h±<hm> Move to horizontal position 

on current line 21 

m<digit> Move to marked position 

\i±<hm> Short horiz. relative move 23 

\m<digit> Mark current horizontal 

position 29 

\t Move to next tab stop (^I) 37 

Backup width of previous character 
("H) 46 

Substitution Commands 

\a<3 digit> Substitute ASCII char. 11 

\s<digit> Substitute corresponding 

+SU substitution string 35 

f Current file name 

# Current page number 


Vertical Motion Commands 

\v±<vm> Move vertically on page 41 
m<digit> Move to vertical position 27 

\l±<vm> Set interline spacing 27 

\n<digit> Mark current vert, position 30 

\p Start new page ("L) 32 

\q<vm> Conditional new page 33 


<^ional + or —; <lmi> is horizoatal measure; <vm> is vertical measure, for example: 1.25i 
?! Ibr <hm>'aiid <vm> are 'i’ inches; *c’ centimeters; dots; ‘u’ user defined (see +UU) 


Efont Commands oase 


Cfont Commands ] 


Load a font set 

118 

m 

Enter Hershey to font mappings 

148 

Save a font set 

125 

1 

Load Hershey to font mappings 


Print expanded form of chars. 

121 


from file 

147 

Edit a set of characters (create 


g 

Generate font 

145 

edf file for each) 

117 

z 

Remove previously specified 


Replace a set of characters (from 



mappings (zap) 

153 

edf files) 

123 

d 

Display current mappings, etc. 

142 

Dbplay expanded character 

115 

P 

Print selected Hershey characters 

150 

Modify margins for set of chars. 

119 

f 

Set character scaling factors 

143 

Test font by printing chars. 

126 

b 

Set baseline (to move chars up 


Remove a set of characters (zap) 128 


or down) 

140 

Move characters up or down (use 


s 

Save current mappings to file 

152 

vlth ‘e’ and ‘r’) 

127 

q 

Quit 

151 

display ic modify font info. 

113 





Suit 








Appendix 9 — Parameter and Command Summary 

Pfon t Printing Parameters 


^ont Selection Parameters signifies ‘Control’ char.) 

?0 Font file names, list of up to 10 (15 DOS) fonts 
ID Rough draft selection, integer between 0 and 6 (roughest) 
>D Screen display, display on screen instead of printing 

^rint Control Parameters 

No header or footer line on first page 
Pause between pages, to allow paper loading 
^F Process form feeds (*L characters as \p) 
rP First page to begin printing, integer between 1 and 9999 
^P Last page to print, integer between 1 and 9999 

Number of copies to print, integer between 1 and 9999 

Page Setup Parameters 

IL Header line, list of 1 or 2 strings (2 if odd/even headers) 
Footer line, list of 1 or 2 strings (2 if odd/even footers) 
^N Initial page number for \s#, integer between 0 and 9999 


default page 

[off] 

1 71 


[off] 

1 93 


off 

1 97 


[off] 

1 85 


off; 

91 


on] 

86 


off] 

1 73 


off 

81 


1] 

84 


loff] 

75 


off 

68 


[1] 

89 


Horizontal Formatting Parameters (<hm> is ‘horizontal measure’; e.g. 1.25i) 

.8i] 101 

6,5i] 82 

li] 79 


FB Set tab stops, list of up to 15 <hm>, 1 <hm> for even tabs 

Line width from left margin, <hm> between 0 and 8 (13.6) inches 
jM Left margin, <hm> between 0 and 8 (13.6) inches 


Vertical Formatting Parameters (<vm> is ‘vertical measure’; e.g. .75i) 

3M Margin from top of page to header, <vm> between 0 and 425 inches 
rM Margin from bottom of page to footer, <vm> between 0 and 425 inches 
PM Margin from page top to text, <vm> between 0 and 425 inches 
3M Margin from bottom of page to text, <vm> between 0 and 425 inches 
^L Total page (paper) length, <vm> between 0 and 425 inches 
Enable pagination 

Enable reverse paper motion (if printer supports, [on] for FX80) 

>P ^Spacing between lines, <vm> between -425 and 425 inches 


.251 

1 77 

.25i 

[ 70 

.75i 

102 

.75i 

63 

Hi] 

88 

on] 

87 

off] 

95 

[.045i] 98 


Uiscellaneous Parameters 


ri Names of files to be printed, list of up to 15 file names (tty;,con,loop:) 
2F Concatenate files 

)U Strings to substitute for \s, list of up to 10 strings 
S Initialization string, string inserted at beginning of each file 
JU User defined unit for ‘u’, list of 1 or 2 real numbers 
Specify alternate command indicator, a single character 


_— 

66 

on] 

64 

off] 

1 99 

off 

78 

off 

103 

[\] 

65 


^During Printing* Commands 

Z (X for CP/M) Stop printing 
N ("P) Immediately print next page 
D Select horizontal rough draft 
E Paui,c aftei current page 
F Immediately print next input file 

'a.'- 


Special Characters 

? Display quick help-(try *V) 

@ Read parameters from file 
^ End a list or start printing 
^ Display current parameter settings 
*U,"H Line delete. Character delete 

Copyright €) 1984 SoftCraft, Inc 




